MCP 代理服务器

一个通过单一接口聚合并提供多个MCP资源服务器服务的MCP代理服务器。此服务器充当中央枢纽，可以：

• 连接到并管理多个MCP资源服务器
• 通过统一接口暴露它们的综合能力
• 处理请求到适当后端服务器的路由
• 聚合来自多个来源的响应

功能

资源管理

• 发现并连接到多个MCP资源服务器
• 聚合所有已连接服务器的资源
• 在服务器之间保持一致的URI方案
• 处理资源路由和解析

工具聚合

• 暴露所有已连接服务器的工具
• 将工具调用路由到适当的后端服务器
• 维护工具状态并处理响应

提示处理

• 聚合所有已连接服务器的提示
• 将提示请求路由到适当的后端
• 处理多服务器提示响应

配置

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

cp config.example.json config.json

示例配置结构：

{
  "servers": [
    {
      "name": "服务器1",
      "transport": {
        "command": "/path/to/server1/build/index.js"
      }
    },
    {
      "name": "服务器2",
      "transport": {
        "command": "server2-command",
        "args": ["--option1", "value1"],
        "env": ["SECRET_API_KEY"]
      }
    },
    {
      "name": "示例服务器3",
      "transport": {
        "type": "sse",
        "url": "http://localhost:8080/sse"
      }
    }
  ]
}

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

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

开发

安装依赖项：

npm install

构建服务器：

npm run build

开发模式下自动重建：

npm run watch

持续运行的开发模式：

# 标准输入输出
npm run dev
# 服务器发送事件
npm run dev:sse

安装

要在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": "/绝对路径/到你的/config.json",
        "KEEP_SERVER_OPEN": "1"
      }
    }
  }
}

• KEEP_SERVER_OPEN将在客户端断开连接时仍保持SSE运行。当多个客户端连接到MCP代理时非常有用。

调试

由于MCP服务器通过标准输入输出通信，调试可能会很困难。我们推荐使用MCP Inspector，它作为一个包脚本可用：

npm run inspector

Inspector将提供一个URL，以便您可以在浏览器中访问调试工具。