MCP Proxy Server

🚀 MCP 代理服务器

MCP 代理服务器是一个强大的工具，它能够聚合并通过单个接口提供多个 MCP 资源服务器的服务。作为中心枢纽，它可以连接和管理多个 MCP 资源服务器，通过统一接口暴露综合功能，处理请求路由，并聚合多来源的响应。

🚀 快速开始

MCP 代理服务器使用前需进行配置，配置完成后即可运行。以下是详细步骤：

1. 复制示例配置文件并按需修改：

cp config.example.json config.json

2. 运行服务器时提供配置文件：

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

✨ 主要特性

资源管理

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

工具聚合

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

提示处理

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

📦 安装指南

与 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 代理很有用。

💻 使用示例

基础用法

配置文件示例

{
  "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

带有连续运行的开发

# 标准输入输出
npm run dev
# SSE
npm run dev:sse

调试

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

npm run inspector

Inspector 将提供访问浏览器中的调试工具的 URL。