MCP-Gateway

MCP-Gateway 是一个提供 MCP Server 统一管理能力的服务，帮助 AI Agents 快速连接到各种数据源。通过 MCP Server，AI Agents 可以轻松访问数据库、REST API 和其他外部服务，而无需担心具体的连接细节。

特性

• HTTP 接口管理：支持导出 OpenAPI 结构，将 HTTP 转换为 MCP Server YAML 格式，以及接口的版本控制。
  • 将 curl 命令转换为 HTTP 接口：轻松将 curl 命令转换为格式正确的 HTTP 接口。
  • 导入/导出 OpenAPI：在 HTTP 接口和 OpenAPI 规范之间进行转换，以便轻松与现有 API 框架集成。
• MCP Server 管理：支持管理 MCP Server 元数据，选择多个 HTTP 结构来更新元数据，发布 MCP Server（编译为 WebAssembly 以进行动态加载），以及版本控制。
• 路由管理：支持路由配置，例如将 xxx/mcp-server/{name} 匹配到名称为 {name} 的 MCP Server。

架构

MCP-Gateway 由三个核心模块组成：

1. HTTP 接口管理：定义和管理 API 配置。
2. MCP Server 管理：管理 MCP Server 实例，将其编译为 WebAssembly，并处理运行时执行。
3. 路由管理：管理 MCP Server 的路由规则。

快速开始

前提条件

• Go 1.19 或更高版本
• Git

安装

1. 克隆仓库：

   git clone https://github.com/wangfeng/mcp-gateway2.git
   cd mcp-gateway2
   

2. 安装依赖：

   go mod tidy
   

3. 运行服务器：

   go run cmd/server/main.go
   

4. 服务器默认在 8080 端口启动。您可以通过设置 PORT 环境变量来自定义端口。

测试

要测试 API，请运行测试客户端：

go run test/client.go

这将：

1. 列出可用的 HTTP 接口
2. 使用其中一个接口创建 MCP Server
3. 将 MCP Server 编译为 WebAssembly
4. 激活 MCP Server
5. 在 MCP Server 上调用一个工具

要测试 curl 转换功能，请运行 curl 测试客户端：

go run test/curl/curl_client.go

这将：

1. 将几个 curl 命令转换为 HTTP 接口
2. 使用转换后的接口创建 MCP Server
3. 编译并激活 MCP Server
4. 从 MCP Server 调用一个工具

要测试 OpenAPI 转换功能，请运行 OpenAPI 测试客户端：

go run test/openapi/openapi_client.go

这将：

1. 将现有的 HTTP 接口导出为 OpenAPI 格式
2. 导入一个示例 OpenAPI 规范以创建新的 HTTP 接口
3. 执行往返转换（导出到 OpenAPI 并导入回来）

API 文档

HTTP 接口

• GET /api/http-interfaces: 列出所有 HTTP 接口
• GET /api/http-interfaces/:id: 获取特定的 HTTP 接口
• POST /api/http-interfaces: 创建一个新的 HTTP 接口
• PUT /api/http-interfaces/:id: 更新 HTTP 接口
• DELETE /api/http-interfaces/:id: 删除 HTTP 接口
• GET /api/http-interfaces/:id/versions: 获取 HTTP 接口的所有版本
• GET /api/http-interfaces/:id/versions/:version: 获取 HTTP 接口的特定版本
• GET /api/http-interfaces/:id/openapi: 将 HTTP 接口导出为 OpenAPI 格式
• POST /api/http-interfaces/from-curl: 从 curl 命令创建一个新的 HTTP 接口
• POST /api/http-interfaces/from-openapi: 从 OpenAPI 规范创建新的 HTTP 接口

MCP Servers

• GET /api/mcp-servers: 列出所有 MCP Server
• GET /api/mcp-servers/:id: 获取特定的 MCP Server
• POST /api/mcp-servers: 从 HTTP 接口创建一个新的 MCP Server
• PUT /api/mcp-servers/:id: 更新 MCP Server
• DELETE /api/mcp-servers/:id: 删除 MCP Server
• GET /api/mcp-servers/:id/versions: 获取 MCP Server 的所有版本
• GET /api/mcp-servers/:id/versions/:version: 获取 MCP Server 的特定版本
• POST /api/mcp-servers/:id/compile: 将 MCP Server 编译为 WebAssembly
• POST /api/mcp-servers/:id/activate: 激活 MCP Server
• POST /api/mcp-servers/:id/tools/:tool: 在 MCP Server 中调用一个工具

Curl 到 HTTP 接口转换

系统支持将 curl 命令转换为 HTTP 接口。只需将 POST 请求发送到 /api/http-interfaces/from-curl，并包含以下 JSON 正文：

{
  "command": "curl -H \"Content-Type: application/json\" https://api.example.com/resource",
  "name": "example-api",
  "description": "Example API endpoint"
}

系统将解析 curl 命令并创建一个格式正确的 HTTP 接口，该接口可用于创建 MCP Server。

OpenAPI 转换

导出到 OpenAPI

您可以通过向 /api/http-interfaces/:id/openapi 发送 GET 请求，将任何 HTTP 接口导出为 OpenAPI 格式。响应将是格式正确的 OpenAPI 3.0.0 规范，可与其他 OpenAPI 工具一起使用。

从 OpenAPI 导入

您可以通过向 /api/http-interfaces/from-openapi 发送 POST 请求，并包含以下 JSON 正文，从 OpenAPI 规范创建新的 HTTP 接口：

 go run test/openapi/openapi_client.go

{
  "name": "my-api",
  "description": "My API description",
  "spec": {
    "openapi": "3.0.0",
    "info": {
      "title": "Sample API",
      "description": "A sample API",
      "version": "1.0.0"
    },
    "paths": {
      "/users": {
        "get": {
          "summary": "Get all users",
          "responses": {
            "200": {
              "description": "A list of users"
            }
          }
        }
      }
    }
  }
}

系统将解析 OpenAPI 规范，并为每个路径/操作组合创建 HTTP 接口。

许可证

MIT

参考

• Higress MCP 快速入门
• Higress MCP Server
• GJSON 模板