MCP Server Metatool

🚀 MCP 服务器 MetaTool

MCP 服务器 MetaTool 是一个代理服务器，可连接多个 MCP 服务器，并将工具调用转发至相应服务器，搭配 metatool-app 使用，能高效管理 MCP 工具。

🚀 快速开始

此仓库已不再维护！请查看这个 Node.js 替代方案：metatool-ai/mcp-server-metamcp。它具有 性能更好 和 更少的错误。(我是那个项目的作者)

你需要一个 MCP 客户端来连接到此服务器才能使用它。

✨ 主要特性

• 作为代理服务器，连接多个 MCP 服务器并转发工具调用。
• 与 metatool-app 配合使用，实现 MCP 工具的高效管理。
• 合并所有 MCP 服务器的工具并进行命名空间隔离。

📦 安装指南

使用 uv 是最佳方式，需要设置 METATOOL_API_KEY 环境变量。

export METATOOL_API_KEY="my_api_key" # 从 metatool-ai/metatool-app 获取，它是可自行托管的免费版本
uvx mcp-server-metatool

📚 详细文档

概述

MetaTool MCP 服务器是一个代理服务器，用于连接多个 MCP 服务器，并将工具调用转发到相应的服务器。它应与 metatool-app 配合使用，这是一个用于 MCP 的开源 GUI 工具管理器。

sequenceDiagram
    参与者 MCPClient 作为 MCP 客户端（例如 Claude Desktop）
    参与者 MetaToolMCP 作为 MetaTool MCP 服务器
    参与者 MetaToolApp 作为 MetaTool 应用程序
    参与者 MCPServers 作为 MetaTool 应用程序中安装的 MCP 服务器

    MCPClient ->> MetaToolMCP: 请求工具列表
    MetaToolMCP ->> MetaToolApp: 获取工具配置和状态
    MetaToolApp ->> MetaToolMCP: 返回工具配置和状态

    循环 对于每个列出的 MCP 服务器
        MetaToolMCP ->> MCPServers: 请求 list_tools
        MCPServers ->> MetaToolMCP: 返回工具列表
    结束循环

    MetaToolMCP ->> MetaToolMCP: 汇总工具列表
    MetaToolMCP ->> MCPClient: 返回汇总的工具列表

    MCPClient ->> MetaToolMCP: 调用工具
    MetaToolMCP ->> MCPServers: 将 call_tool 请求转发到目标 MCP 服务器
    MCPServers ->> MetaToolMCP: 返回工具响应
    MetaToolMCP ->> MCPClient: 返回工具响应

工作原理

• mcp-server-metatool 本身既是 MCP 客户端又是 MCP 服务器。
• 在启动时，它连接到 metatool-app API 以获取要连接的 MCP 服务器列表。
• 在 list_tools 的 MCP 调用中，它将所有 MCP 服务器的工具合并在一起，并具有命名空间隔离。
• 在 call_tool 的 MCP 调用中，它将调用转发到相应的服务器。

额外配置

可以设置 METATOOL_API_BASE_URL 环境变量以指向另一个 MetaTool 实例。

export METATOOL_API_BASE_URL="http://localhost:12005"

📄 许可证

本项目采用 Apache License 2.0 许可证。