Toolhive

🚀 工具Hive 使用指南

本指南將詳細介紹工具Hive的安裝與使用方法，幫助你快速上手並充分利用其功能。

🚀 快速開始

工具Hive是一款功能強大的工具，能幫助你高效運行MCP服務器等任務。下面將為你介紹其安裝和基本使用方法。

📦 安裝指南

通過以下命令可快速安裝工具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 文件。