Higress 网关与 MCP Server 集成指南
Higress 是一款云原生 API 网关,集成了流量、微服务及安全功能。它基于 Istio 和 Envoy 开发,支持 Go/Rust/JS 等语言编写 Wasm 插件。除了传统的网关能力,Higress AI 网关现在也支持多种 AI 服务提供商(如 OpenAI、DeepSeek、通义千问等),并具备令牌限流、消费者鉴权、WAF 防护及语义缓存等功能。
核心能力:REST API 转 MCP Server
通过 mcp-server 插件,我们可以利用 Model Context Protocol (MCP) 标准,让 AI 模型与外部工具和资源进行交互。这相当于把现有的 REST API 直接变成了 AI 助手可调用的工具,无需额外编写代码。
主要优势包括:
- 零代码接入:将现有 REST API 快速转换为 AI 工具。
- 统一治理:复用 Higress 的认证、鉴权、限流和可观测性能力,确保安全性和性能。
- 快速部署:通过插件机制,几分钟内即可添加新的 MCP Server。
注意:插件默认在运行阶段执行,优先级为 30。
配置详解
Server 基础配置
首先需要定义一个 Server,指定名称和必要的配置信息。
| 字段名 | 数据类型 | 必填 | 描述 |
|---|---|---|---|
server.name | string | 是 | MCP Server 的名称。内置 Server(如 quark-search)只需填此项;REST-to-MCP 场景可自定义。 |
server.config | object | 否 | 服务器级配置,例如 API 密钥等。默认为空对象。 |
server.allowTools | array | 否 | 允许调用的工具列表。不指定则允许所有工具。 |
定义 REST-to-MCP 工具
这是最关键的部分,我们需要定义如何将 HTTP 请求映射到 AI 工具参数。
工具参数定义
每个工具 (tools) 需要包含名称、描述以及参数 (args) 的详细定义。参数类型支持 string、number、integer、boolean、array 和 object。对于数组或对象类型,还需进一步定义 items 或 properties 模式。
请求模板 (Request Template)
你需要告诉 Higress 如何构造 HTTP 请求。这里支持四种互斥的参数传递方式:
- JSON Body: 参数直接作为 JSON 对象发送,自动设置
Content-Type: application/json。 - : 参数追加到 URL 查询字符串中。


