Higress 是一款云原生 API 网关,集成了流量、微服务、安全及 AI 网关功能。它基于 Istio 和 Envoy 构建,支持使用 Go、Rust 或 JS 编写 Wasm 插件,并提供了开箱即用的控制台。
在 AI 集成场景下,Higress 的 MCP Server 插件允许我们将现有的 REST API 快速转换为 AI 助手可调用的工具,无需额外开发代码。这不仅利用了网关统一的认证、鉴权、限流和可观测能力,还显著提升了构建效率。
核心功能与运行属性
MCP Server 插件基于 Model Context Protocol (MCP) 标准,定义了 AI 模型与外部工具交互的方式。
- 零代码转换:将 REST API 映射为 AI 工具。
- 统一治理:复用 Higress 的安全与性能策略。
- 快速部署:通过插件机制即时生效。
该插件默认阶段执行,优先级设为 30,确保在请求处理流程中的位置合理。
配置详解
Server 基础配置
| 字段名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
server.name | string | 是 | - | MCP Server 名称。内置服务(如 quark-search)仅需此项;REST-to-MCP 场景可自定义。 |
server.config | object | 否 | {} | 服务器配置,例如 API 密钥等敏感信息。 |
server.allowTools | array | 否 | - | 允许调用的工具白名单,未指定则开放全部。 |
REST-to-MCP 工具定义
这是最核心的部分,用于描述如何将 HTTP 请求转化为 AI 理解的工具调用。
| 字段名 | 类型 | 必填 | 说明 |
|---|---|---|---|
tools[].name | string | 是 | 工具名称 |
tools[].description | string | 是 | 工具功能描述,AI 据此判断何时调用 |
tools[].args | array | 是 | 参数定义列表 |
tools[].requestTemplate | object | 是 | HTTP 请求模板 |
tools[].responseTemplate | object | 是 | 响应转换模板 |
参数类型支持
为了更精确地定义工具输入,支持多种数据类型:
string:字符串(默认)number:浮点数integer:整数


