🚀 MCP 代理服务器

MCP 代理服务器是一个强大的工具，它能聚合并提供多个 MCP 资源服务器的服务。通过统一接口，它实现了对多个 MCP 资源服务器的集中管理，解决了资源分散、管理不便的问题，为用户提供了高效便捷的使用体验。

🚀 快速开始

MCP 代理服务器作为中央枢纽，具备连接和管理多个 MCP 资源服务器的能力。它通过统一接口暴露综合功能，处理请求到适当后端服务器的路由，并聚合来自多个来源的响应。

✨ 主要特性

资源管理

• 自动发现并连接多个 MCP 资源服务器。
• 聚合所有连接服务器的资源，实现资源的统一获取。
• 维持服务器之间一致的 URI 方案，便于资源的管理和访问。
• 高效处理资源路由和解析，确保资源的准确获取。

工具聚合

• 暴露所有连接服务器中的工具，方便用户统一调用。
• 将工具调用精准路由到适当的后端服务器，提高工具使用效率。
• 维护工具状态并处理响应，保障工具的稳定运行。

提示处理

• 聚合来自所有连接服务器的提示，为用户提供全面的信息。
• 将提示请求路由到合适的后端，确保提示的准确性。
• 处理多台服务器的提示响应，提高提示处理的效率。

📦 安装指南

配置服务器

该服务器需要一个 JSON 配置文件，指定要连接的 MCP 服务器。复制示例配置并根据需要进行修改：

cp config.example.json config.json

示例配置结构：

{
  "servers": [
    {
      "name": "Server 1",
      "transport": {
        "command": "/path/to/server1/build/index.js"
      }
    },
    {
      "name": "Server 2",
      "transport": {
        "command": "server2-command",
        "args": ["--option1", "value1"]
      }
    }
  ]
}

配置文件在运行服务器时必须提供：

MCP_CONFIG_PATH=./config.json mcp-proxy-server

与 Claude Desktop 集成

要与 Claude Desktop 一起使用，请添加服务器配置：

• 在 MacOS 上：~/Library/Application Support/Claude/claude_desktop_config.json
• 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-proxy": {
      "command": "/path/to/mcp-proxy-server/build/index.js",
      "env": {
        "MCP_CONFIG_PATH": "/absolute/path/to/your/config.json"
      }
    }
  }
}

💻 使用示例

开发环境搭建

安装依赖项

npm install

构建服务器

npm run build

带自动重建进行开发

npm run watch

调试

由于 MCP 服务器通过 stdio 通信，调试可能具有挑战性。我们推荐使用 MCP Inspector，它作为包脚本可用：

npm run inspector

Inspector 将提供访问调试工具的 URL，在您的浏览器中打开即可。