MCP Gateway 236

🚀 MCP 网关

MCP 网关是一个反向代理服务器，它能将客户端请求转发至 MCP 服务器，也可通过统一入口调用多个 MCP 服务器，为用户提供便捷、高效的服务。

🚀 快速开始

MCP 网关可帮助你轻松管理和使用 MCP 服务器，以下是快速开始的步骤。

✨ 主要特性

• 支持部署多个 MCP 服务器，满足多样化的业务需求。
• 能够连接到 MCP 服务器，实现数据交互。
• 可通过网关调用 MCP 服务器的功能。
• 能获取所有 MCP 服务器的 SSE 流，实时获取数据。
• 可获取所有 MCP 服务器的工具列表。

⚠️ 重要提示

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

📦 安装指南

从 GitHub 拉取镜像包

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

自行构建 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

📚 详细文档

部署 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 定义了每个工具的具体参数要求。

注意事项

错误处理

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

日志与监控

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

扩展性

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