MCP Gateway2

🚀 MCP-Gateway 中文版

MCP-Gateway 是一款用於統一管理 MCP 服務器的服務，它能助力 AI 代理快速連接各類數據源。藉助 MCP 服務器，AI 代理可輕鬆訪問數據庫、REST API 及其他外部服務，無需關注具體的連接細節。

✨ 主要特性

• HTTP 接口管理：支持導出 OpenAPI 結構、將 HTTP 轉換為 MCP 服務器 YAML 格式以及進行接口版本控制。
  • curl 命令轉 HTTP 接口：可輕鬆把 curl 命令轉換為規範的 HTTP 接口。
  • OpenAPI 導入/導出：能在 HTTP 接口和 OpenAPI 規範之間進行轉換，便於與現有 API 框架集成。
• MCP 服務器管理：支持 MCP 服務器元數據管理、選擇多個 HTTP 結構以更新元數據、發佈 MCP 服務器（編譯為 WebAssembly 以便動態加載）以及版本控制。
• 路由管理：支持路由配置，例如可將xxx/mcp-server/{name}映射到名為{name}的 MCP 服務器。

🔧 技術細節

MCP-Gateway 由三個核心模塊構成：

1. HTTP 接口管理：負責定義和管理 API 配置。
2. MCP 服務器管理：管理 MCP 服務器實例，將其編譯為 WebAssembly 並處理運行時執行。
3. 路由管理：管理 MCP 服務器的路由規則。

🚀 快速開始

先決條件

• Go 1.19 或更高版本
• Git

📦 安裝指南

1. 下載代碼：

git clone [Repository URL]
cd mcp-gateway

2. 安裝依賴項：

go mod tidy

3. 運行主程序：

go run main.go

測試

運行以下命令以執行集成測試：

go test -v ./...

📚 詳細文檔

💻 使用示例

基礎用法

HTTP 接口創建

通過發送 POST 請求到/api/http-interfaces，幷包含以下 JSON 正文來創建 HTTP 接口：

{
  "name": "test-interface",
  "description": "Test interface description",
  "methods": ["GET", "POST"],
  "path": "/test",
  "request": {
    "headers": {
      "Content-Type": "application/json"
    },
    "body": {
      "schema": {
        "$ref": "#/components/schemas/TestRequest"
      }
    }
  },
  "response": {
    "status": 200,
    "headers": {
      "Content-Type": "application/json"
    },
    "body": {
      "schema": {
        "$ref": "#/components/schemas/TestResponse"
      }
    }
  }
}

MCP 服務器創建

通過發送 POST 請求到/api/mcp-servers，幷包含以下 JSON 正文來創建 MCP 服務器：

{
  "name": "test-server",
  "description": "Test server description",
  "interface": "test-interface",
  "endpoint": "http://localhost:8080"
}

📄 許可證

MIT

參考資料

• Higress MCP 快速入門
• Higress MCP 服務器
• GJSON 模板