MCP Proxy Server

MCP Proxy 服务

一个 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"],
        "env": ["SECRET_API_KEY"]
      }
    },
    {
      "name": "Example Server 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

开发时持续运行：

# Stdio
npm run dev
# SSE
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": "/absolute/path/to/your/config.json",
        "KEEP_SERVER_OPEN": "1"
      }
    }
  }
}

• KEEP_SERVER_OPEN 会在客户端断开连接后继续运行 SSE。多个客户端连接到 MCP 代理时，这会很有用。

调试

由于 MCP 服务通过 stdio 通信，调试可能颇具挑战。我们建议使用 MCP Inspector，它可通过包脚本运行：

npm run inspector

Inspector 会提供一个 URL，供你在浏览器中访问调试工具。