MCP Server 快速开始

注意： 本文档中的 MCP Server 功能需要 Higress 2.1.0 或更高版本。

Higress AI 网关提供 MCP Server 统一托管能力，可以帮助 AI Agent 快速对接各类数据源。通过 MCP Server，AI Agent 可以方便地访问数据库、REST API 等外部服务，无需关心具体的连接细节。其中，数据库对接能力是网关内置的能力；而对于 REST API，任何外部 REST API 都可以通过简单的配置转换成 MCP Server。本文将以 PostgreSQL 数据库和一个简单的 REST API 为例，介绍配置流程。

前提条件

在开始使用 MCP Server 之前，需要先部署 Higress。您可以参考 Higress 快速入门指南 完成部署。在安装 Higress 时，请确保在 Helm 命令中添加以下参数：

helm install higress -n higress-system [...其他参数...] --set global.enableRedis=true

MCP Server 需要依赖 Redis 服务用于数据缓存，启用后您可以通过以下命令查看 Redis 服务的地址：

kubectl get svc redis-stack-server -n higress-system -o wide

如果 Redis 服务启动正常，你会得到类似如下形式的输出：

NAME                 TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)    AGE   SELECTOR
redis-stack-server   ClusterIP   192.168.51.87   <none>        6379/TCP   10s   app.kubernetes.io/instance=higress,app.kubernetes.io/name=redis-stack-server

配置 MCP Server

全局参数配置

在系统设置中配置 MCP Server 的相关全局参数：

apiVersion: v1
data:
  higress: |-
    mcpServer:
      sse_path_suffix: /sse  # SSE 连接的路径后缀
      enable: true          # 启用 MCP Server
      redis:
        address: redis-stack-server.higress-system.svc.cluster.local:6379 # Redis服务地址
        username: "" # Redis用户名（可选）
        password: "" # Redis密码（可选）
        db: 0 # Redis数据库（可选）
      match_list: []
      servers: []
...

kind: ConfigMap
metadata:
  name: higress-config
  namespace: higress-system

配置 REST API MCP Server 作为服务来源

在 Higress 控制台添加目标 REST API 的服务来源，本示例使用公网服务 randomuser.me ：

配置 Nacos 作为服务来源 (Optional)

注意： 需要Nacos版本为3.0及以上，Higress版本在2.1.2及以上

创建Nacos3.x服务来源并完善相关信息

配置 MCP 管理

进入 MCP 管理界面：

创建 MCP 服务：

注意：

1. 对于 DB 类型的 MCP 服务需要额外配置：

2. 对于 OpenAPI 类型的 MCP 服务，需要在创建后编辑工具规范，可以使用 OpenAPI/Swagger 规范或直接使用 MCP 工具，这里以 MCP 为例：

server:
  name: "random-user-server"
tools:
- description: "Get random user information"
  name: "get-user"
  requestTemplate:
    method: "GET"
    url: "https://randomuser.me/api/"
  responseTemplate:
    body: |-
      # User Information
      {{- with (index .results 0) }}
      - **Name**: {{.name.first}} {{.name.last}}
      - **Email**: {{.email}}
      - **Location**: {{.location.city}}, {{.location.country}}
      - **Phone**: {{.phone}}
      {{- end }}

使用 MCP Server

在 AI Agent 中配置 MCP Server 的 Streamable HTTP/SSE 连接，参考 MCP 服务中的连接信息：

以 Cursor 为例，进入 Cursor Settings - Tools & Integrations - Add Custom MCP，填入如下内容：

{
  "mcpServers": {
    "user": {
      "url": "http://<higress-gateway-ip>/mcp-servers/user/sse"
    }
  }
}

Cursor 中配置完成：

通过 MCP Server，您可以快速为 AI Agent 添加各种数据源支持，提高开发效率。任何 REST API 都可以通过简单的配置转换为 MCP Server，无需编写额外的代码。

如您在使用 MCP Server 过程中遇到问题，可在 Higress Github Issue 中留下您的信息。

如您对 Higress 后续更新感兴趣，或希望给 Higress 提供反馈，欢迎 Star Higress Github Repo。

您可以使用 OpenAPI to MCP 工具，实现 OpenAPI 规范文档到 MCP Server 配置的自动转换