MCP Gateway 236

🚀 MCP 網關

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 查看運行日誌。

擴展性

• 支持插件式擴展，用戶可以根據需求添加自定義功能模塊。
• 提供豐富的配置選項，允許用戶自定義網關行為。