Adamwattis MCP Proxy Server

🚀 MCP 代理服务器

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，在浏览器中打开即可。