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 模板