Utcp MCP

🚀 UTCP-MCP 橋接器

UTCP-MCP 橋接器是一款通用的一體化 MCP 服務器，它將通用工具調用協議（UTCP）的強大功能引入 MCP 生態系統。藉助該項目，你可以：

• 將 UTCP 用作代理：立即將通過 UTCP 註冊的所有工具以 MCP 兼容的形式暴露出來，供任何 MCP 客戶端使用。
• 直接使用 UTCP 客戶端：註冊和註銷提供者，搜索和調用工具，從一個地方解鎖 UTCP 客戶端的主要功能。
• Web 界面：通過用戶友好的 Web UI 輕鬆管理你的工具和提供者。只需點擊幾下，即可註冊和註銷提供者、啟用和禁用工具等。更多功能即將推出！

有了 UTCP-MCP 橋接器，無論你想如何使用，只需安裝一個 MCP 服務器，就能訪問、管理和擴展你的工具生態系統。

🚀 快速開始

你可以通過兩種方式運行 UTCP-MCP 橋接器：使用 Docker 或本地 bash 腳本。

🐳 使用 Docker 運行

確保你已安裝 Docker 和 Docker Compose。

docker-compose up --build

💻 使用 Bash 腳本運行

確保你已安裝 Python 3。

./run.sh

🐚 使用 PowerShell 腳本運行

確保你已安裝 Python 3。

./run.ps1

這將：

• 使用所有依賴項設置 Python 虛擬環境或構建 Docker 鏡像。
• 啟動 MCP 服務器和 WEB 服務器。
• 暴露以下端口：
  • 8776（UTCP 客戶端 MCP）
  • 8777（UTCP 代理 MCP）
  • 8778（FastAPI Web 服務器）

🔗 連接你選擇的 MCP 客戶端

要將你的 MCP 客戶端連接到 UTCP-MCP 橋接器，請將以下條目添加到客戶端的 mcp.json（或等效配置文件）中：

光標示例：

{
  "mcpServers": {
    // 任何其他 mcp 服務器
    "utcp-proxy-mcp-local": {
      "url": "http://localhost:8777/utcp-proxy"
    },
    "utcp-client-mcp-local": {
      "url": "http://localhost:8776/utcp-client"
    }
  }
}

VS Code 示例：

{
  "servers": {
    // 任何其他 mcp 服務器
    "utcp-proxy-mcp-local": {
      "url": "http://localhost:8777/utcp-proxy",
      "type": "http"
    },
    "utcp-client-mcp-local": {
      "url": "http://localhost:8776/utcp-client",
      "type": "http"
    }
  },
  "inputs": []
}

• utcp-proxy-mcp-local 連接到 UTCP 代理 MCP 服務器（端口 8777）。
• utcp-client-mcp-local 連接到 UTCP 客戶端 MCP 服務器（端口 8776）。

如果你在不同的主機或端口上運行服務器，請調整 URL。

🌐 UI 界面

在任何瀏覽器中訪問 http://localhost:8778/ 即可查看和管理提供者與工具的 Web 界面。

⚙️ 配置

• 提供者和工具定義從 data/ 目錄（例如 data/providers.json）加載。
• 可以在 Docker Compose 或你的 shell 中設置環境變量，以自定義端口和路徑。

📚 API 端點

• / – Web 界面
• /health – 健康檢查和狀態
• /tools – 列出可用工具
• /providers – 列出可用提供者

📦 依賴項

• utcp
• fastmcp
• fastapi
• python-dotenv

所有依賴項都會由 Docker 鏡像或 bash 腳本自動安裝。