MCP Simple Gateway

MCP Simple Gateway

MCP Simple Gateway 是一个用于模型上下文协议（MCP）的代理服务，可通过单一接口聚合和管理多个 MCP 服务。

主要功能

• 🚀 聚合多个 MCP 服务
• 🔒 支持基于令牌的身份验证
• 📝 灵活的基于 JSON 的配置
• 🐳 支持 Docker
• 🔌 支持 SSE、stdio 和 StreamableHTTP MCP

使用方法

通过 CLI 运行

npx mcp-simple-gateway --config config.json

通过 Docker Compose 运行

docker-compose.yml 示例：

services:
  mcp-gateway:
    platform: linux/amd64 # For Apple Silicon Users
    image: ghcr.io/denwakeup/mcp-simple-gateway:latest
    volumes:
      - ./config.json:/app/config.json
    ports:
      - '3000:3000'
    environment:
      - CONFIG_PATH=/app/config.json

配置

配置文件（config.json）示例：

{
  "proxyServer": {
    "logLevel": "debug",
    "logPretty": true,
    "authTokens": ["your-auth-token"],
    "cors": {
      "origin": true
    }
  },
  "mcpServers": {
    "time": {
      "command": "uvx",
      "args": ["mcp-server-time", "--local-timezone=Europe/Moscow"],
      "proxyOptions": {
        "authTokens": ["server-specific-token"]
      }
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/app/files"]
    },
    "echo": {
      "type": "streamableHttp",
      "url": "http://localhost:8080/mcp"
    }
  }
}

配置参数

• proxyServer.options：

  • logLevel：日志级别（debug、info、warn、error）
  • logPretty：日志格式
  • authTokens：身份验证令牌数组（用作所有服务的默认值）
  • cors：CORS 配置选项（可选）

• mcpServers：MCP 服务配置

  • [serverName]：
    • command：启动服务的命令（用于 stdio 服务）
    • args：命令参数（用于 stdio 服务）
    • url：服务的 URL（用于 SSE 和 StreamableHTTP 服务）
    • type：服务类型（stdio 和 SSE 可选，StreamableHTTP 必填）
    • proxyOptions：特定服务的代理选项
      • authTokens：身份验证令牌数组（针对特定服务覆盖 proxyServer.options.authTokens）

根据上述配置，访问 MCP 服务的 URL 如下：

http://localhost:3000/time/sse
http://localhost:3000/filesystem/sse
http://localhost:3000/echo/sse

• localhost:3000 - 代理服务的地址和端口（默认值）
• /time/sse、/filesystem/sse 和 /echo/sse - 对应 MCP 服务的路径，与 mcpServers 配置中的键相对应

路线图

• 支持 CORS
• 支持 Streamable HTTP

许可证

MIT