MCP 服务器代理

一个连接到多个 MCP 服务器并为工具访问提供统一接口的代理服务器。

功能

• 同时连接到多个 MCP 服务器
• 支持多个配置配置文件
• 工具名称以服务器名称为前缀
• 以 stdio 或 SSE 模式运行
• 基于配置文件的配置管理

配置

为每个配置文件创建 config.<profile>.json 格式的配置文件。 例如：

// config.developer.json
{
  "mcpServers": {
    "kubernetes": {
      "command": "npx",
      "args": ["mcp-server-kubernetes"]
    }
  }
}

// config.personal.json
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/mirilale/Desktop"
      ]
    }
  }
}

安装

npm install

用法

命令行选项

可以使用各种命令行选项启动服务器：

# 使用默认设置启动
node dist/server.js

# 使用特定配置文件启动
node dist/server.js --profile developer
# 或
node dist/server.js -p developer

# 以 SSE 模式启动
node dist/server.js --mode sse
# 或
node dist/server.js -m sse

# 以 SSE 模式启动，并使用自定义端口和主机
node dist/server.js --mode sse --port 8080 --host 0.0.0.0

# 组合选项
node dist/server.js --profile developer --mode sse --port 8080

可用选项：

• -p, --profile <name>: 指定要使用的配置文件（默认为“default”）
• -m, --mode <mode>: 在“stdio”或“sse”模式之间选择（默认为“stdio”）
• --port <number>: 设置 SSE 模式的端口（默认为 3000）
• --host <host>: 设置 SSE 模式的主机（默认为“localhost”）

获取帮助：

node dist/server.js --help

工具命名约定

工具以其服务器名称为前缀。 例如：

• 来自 filesystem 服务器的名为 read_file 的工具变为 filesystem_read_file
• 来自 kubernetes 服务器的名为 get_pods 的工具变为 kubernetes_get_pods

SSE 模式端点

在 SSE 模式下运行时，服务器公开以下端点：

• GET /sse: 建立 SSE 连接
• POST /messages: 处理工具请求（需要 sessionId 查询参数）

SSE 客户端使用示例：

const eventSource = new EventSource("http://localhost:3000/sse");
eventSource.onmessage = (event) => {
  console.log("Received:", event.data);
};

错误处理

服务器提供详细的错误消息，包括：

• 配置文件加载错误
• 服务器连接失败
• 未找到工具错误
• 服务器断开连接错误

所有错误都包含当前配置文件名称，以便更好地了解上下文。

开发

# 安装依赖
npm install

# 构建项目
npm run build

# 在开发模式下运行
npm run dev:stdio:developer
# 或
npm run dev:sse:developer

# 使用 mpc inspector 运行
npm run inspect

许可证

MIT