AI导哈

MCP代理服务器

一个聚合多个MCP资源服务器并通过单一接口提供服务的代理服务器，适用于需要集中管理和路由多个MCP资源服务器的场景。

  • by adamwattis
  • TypeScript
  • 本地部署
  • 202 星标
  • 更新于
在 GitHub 查看 adamwattis/mcp-proxy-server

使用说明

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"],
        "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检查员，可作为包脚本使用：

npm run inspector

检查器将提供一个URL，用于访问浏览器中的调试工具。

相关 MCP