JinDaGe - utcp-mcp MCP Details

article

README

🚀 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 脚本自动安装。

utcp-mcp