MCP Local Router

MCP Local Router

该项目是一个 MCP（Model Context Protocol）本地路由器，充当 MCP 服务的聚合代理。它可以连接多个上游 MCP 服务，并将其功能聚合到一个供下游客户端使用的接口中。

功能

• 支持通过命令行参数指定配置文件
• 支持配置多个上游 MCP 服务
• 支持 stdio 传输
• 支持向 stdio 传输注入环境变量
• 支持 SSE 传输，并提供聚合的 /sse 端点和针对各上游服务的 /sse/{serverName} 端点

用法

运行

必须使用配置文件运行：

cargo run -- --config mcp-config.json --transport sse

SSE 路由

路由器以 --transport sse 运行时，会公开两种端点：

• /sse 会流式传输所有已配置上游服务聚合后的工具集合。
• /sse/{serverName} 只会流式传输单个上游服务的工具。{serverName} 部分必须与配置文件中 mcpServers 的键匹配（例如 /sse/filesystem 或 /sse/workspace-search）。

服务名称键应当适合用于 URL，因为它们会直接用作路径部分。

每个 SSE 连接都会发出一个初始 endpoint 事件，其中包含客户端应当用于发送 POST 请求的 HTTP 路径。所有流式端点都共用同一个 POST /message?sessionId=… 通道。

配置文件格式

配置文件采用 JSON 格式，示例如下：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop"
      ],
      "env": {
        "LINEAR_ACCESS_TOKEN": "your_personal_access_token"
      }
    },
    "workspace-search": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-everything"
      ],
      "env": {}
    }
  }
}

说明：

• mcpServers：多个服务配置的映射
  • 每个键是服务名称（用于日志记录和 /sse/{serverName} 路径）
  • 每个值是一个包含以下字段的对象：
    • command：要执行的命令
    • args：命令参数数组
    • env：要注入的环境变量映射

构建和安装

# Build the project
cargo build --release

# Run
cargo run --release -- --config mcp-config.json --transport stdio

依赖项

• Rust 2021 Edition
• tokio 异步运行时
• MCP 相关库：rmcp