Toolhive

🚀 ツールHive 使用ガイド

ツールHiveは、MCPサーバーの実行や管理を容易にするツールです。このドキュメントでは、ツールHiveのインストール方法、基本的な使用法、高度な使用法について説明します。

📦 インストール

以下のコマンドを使用して、ツールHiveを迅速にインストールできます。

curl -L https://github.com/stacklok/toolhive/releases/download/v0.1.0/toolhive-linux-amd64.gz | zcat > /usr/local/bin/toolhive && chmod +x /usr/local/bin/toolhive

💻 使用例

基本的な使用法

MCPサーバーの実行

ツールHiveは、以下のコマンドを使用してMCPサーバーを実行することができます。

toolhive run --transport stdio --name my-mcp-server --port 8080 ./mcp_server.py

または、プロトコルスキームを使用して直接実行することもできます。

toolhive run uvx://awslabs.core-mcp-server@latest

カスタム権限

ツールHiveは、JSONベースの権限設定ファイルを提供しており、--permission-profile フラグを使用して指定することができます。例えば：

{
  "read": ["/var/run/mcp.sock"],
  "write": ["/var/run/mcp.sock"],
  "network": {
    "outbound": {
      "insecure_allow_all": false,
      "allow_transport": ["tcp", "udp"],
      "allow_host": ["localhost", "google.com"],
      "allow_port": [80, 443]
    }
  }
}

Kubernetesでの実行

ツールHiveは、Kubernetesクラスター内でMCPサーバーをデプロイすることをサポートしています。詳細については、以下のドキュメントを参照してください。 kindクラスターでツールHiveを実行する

高度な使用法

カスタムビルド

ツールHiveは、パッケージマネージャーから取得したMCPサーバーを、プロトコルスキームを使用して直接実行することをサポートしています。

• uvx://：PythonベースのMCPサーバー用
• npx://：Node.jsベースのMCPサーバー用
• go://：GoベースのMCPサーバー用

例えば：

toolhive run go://github.com/example/go-mcp-server@latest

高度な機能

ツールHiveは、以下のような豊富な高度な機能を提供しています。

• コンテナリソース制限
• ネットワークポリシー
• ログ収集
• モニタリング統合

🤝 コントリビューションガイド

コミュニティからの貢献を歓迎します！ 参加方法については、CONTRIBUTING.md を参照してください。

📄 ライセンス

このプロジェクトは、Apache 2.0ライセンスの下で提供されています。詳細については、LICENSE ファイルを参照してください。