MCP Server Proxy

MCP Server Proxy

一个可连接多个 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

使用方法

命令行选项

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

# Start with default settings
node dist/server.js

# Start with a specific profile
node dist/server.js --profile developer
# or
node dist/server.js -p developer

# Start in SSE mode
node dist/server.js --mode sse
# or
node dist/server.js -m sse

# Start in SSE mode with custom port and host
node dist/server.js --mode sse --port 8080 --host 0.0.0.0

# Combine options
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);
};

错误处理

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

• 加载配置文件时出错
• 服务连接失败
• 找不到工具
• 服务断开连接

所有错误都包含当前配置文件名称，以便提供更清晰的上下文。

开发

# Install dependencies
npm install

# Build the project
npm run build

# Run in development mode
npm run dev:stdio:developer
# or
npm run dev:sse:developer

# Run with mpc inspector
npm run inspect

许可证

MIT