MCP 网关

说明

MCP 网关是一个反向代理服务器，负责将客户端请求转发到 MCP 服务器，或通过统一入口使用多个 MCP 服务器。

功能

• 部署多个 MCP 服务器
• 连接到 MCP 服务器
• 使用网关调用 MCP 服务器
• 获取所有 MCP 服务器的 SSE 流
• 获取所有 MCP 服务器的工具

目前，STDIO 已转向超级网关（由 supercorp-ai 开源），我们后续将自行实现该功能。

安装

1. 从 GitHub 拉取镜像包

docker pull ghcr.io/lucky-aeon/mcp-gateway:latest

2. 自行构建 Docker 镜像

docker build -t mcp-gateway .

使用方法

运行 GitHub 提供的 Docker 容器：

docker run -d --name mcp-gateway -p 8080:8080 ghcr.io/lucky-aeon/mcp-gateway

运行自建的 Docker 镜像：

docker run -d --name mcp-gateway -p 8080:8080 mcp-gateway

API 文档

部署 MCP 服务器

支持内容类型：

• application/json
• multipart/form-data
• x-www-form-urlencoded

请求路径：

POST /api/deploy

请求体示例：

{
  "mcpServers": {
    "server1": {
      "url": "http://example.com/mcp",
      "command": "python3 mcp_server.py"
    },
    "server2": {
      "url": "http://another.example.com/mcp",
      "command": "java -jar mcp.jar"
    }
  }
}

说明：

• url 和 command 是互斥的字段，表示 MCP 服务器的 URL 地址或启动命令。
• 可选字段包括 args（数组类型，用于传递命令行参数）和 env（对象类型，用于设置环境变量）。

调用 MCP 服务器

获取 SSE 流：

curl -X GET http://localhost:8080/api/mcp/sse

调用方法：

curl -X POST \
     -H "Content-Type: application/json" \
     -d '{"method": "timeConversion", "params": {"source_time": "12:00", "target_timezone": "Asia/Shanghai"}}' \
     http://localhost:8080/api/mcp/call

网关功能

统一入口调用：

所有请求通过 /api/mcp/* 路径转发到对应的 MCP 服务器，自动处理跨域问题。

SSE 流处理：

网关会合并多个 MCP 服务器的 SSE 流，并在结果中标记来源服务器名称。

获取工具列表

请求路径：

GET /api/tools

示例响应：

{
  "tools": [
    {
      "name": "mcpServer1-timeConversion",
      "description": "时间转换工具",
      "inputSchema": {
        "type": "object",
        "properties": {
          "source_time": {
            "type": "string",
            "description": "源时间，格式为 HH:MM"
          },
          "target_timezone": {
            "type": "string",
            "description": "目标时区"
          }
        },
        "required": ["source_time", "target_timezone"]
      }
    },
    {
      "name": "mcpServer1-timeConvert",
      "description": "时间转换工具",
      "inputSchema": {
        "type": "object",
        "properties": {
          "source_time": {
            "type": "string",
            "description": "源时间，格式为 HH:MM"
          },
          "target_timezone": {
            "type": "string",
            "description": "目标时区"
          }
        },
        "required": ["source_time", "target_timezone"]
      }
    }
  ]
}

说明：

• 网关会自动合并所有 MCP 服务器的工具列表，并在结果中标记每个工具所属的 MCP 服务器名称。
• 输入 schema 定义了每个工具的具体参数要求。

注意事项

1. 错误处理：

   • 网关会对请求进行合法性检查，返回统一格式的错误信息。
   • 支持的错误码包括 400（无效请求）、503（服务不可用）等。

2. 日志与监控：

   • 网关提供详细的访问日志和健康状态监控。
   • 可通过 /api/admin/logs 查看运行日志。

3. 扩展性：

   • 支持插件式扩展，用户可以根据需求添加自定义功能模块。
   • 提供丰富的配置选项，允许用户自定义网关行为。