Higress 作为云原生 API 网关，集成了流量管理、微服务治理及安全防护能力。其底层基于 Istio 和 Envoy，支持 Go、Rust、JS 等语言扩展 Wasm 插件。除了常规网关功能外，Higress AI 网关还对接了 OpenAI、DeepSeek 等多种大模型服务，并内置了令牌限流、语义缓存等特性。
其中，MCP Server 插件是连接传统 REST API 与 AI 助手的关键桥梁。它基于 Model Context Protocol (MCP) 标准，让 AI 模型能直接调用外部工具，而无需开发者额外编写适配代码。借助 Higress 网关本身的能力，这些工具天然具备统一的认证、鉴权、限流和可观测性保障。
核心配置说明
插件默认在运行阶段执行，优先级设为 30。配置主要分为 Server 基础信息和具体的 REST-to-MCP 工具映射两部分。
Server 基础配置
定义 MCP Server 的唯一标识及全局设置：
| 字段名 | 类型 | 必填 | 描述 |
|---|---|---|---|
server.name | string | 是 | Server 名称。内置服务（如 quark-search）只需填此项；自定义场景可自由命名。 |
server.config | object | 否 | 全局配置对象，例如存放 API Key。 |
server.allowTools | array | 否 | 允许调用的工具白名单。未指定则开放全部。 |
工具映射配置
这是最核心的部分，用于将 HTTP 接口封装为 AI 可调用的函数。每个工具需明确名称、描述、参数结构以及请求/响应模板。
参数类型支持丰富，包括字符串、数字、布尔值、数组及对象。对于复杂对象或数组，可通过 properties 或 items 进一步定义子模式。
请求参数的传递方式有四种，且相互互斥：
- 表单提交 (
argsToFormBody)：自动编码为application/x-www-form-urlencoded。 - 查询参数 (
argsToUrlParam)：追加到 URL 后。 - JSON 体 (
argsToJsonBody)：自动设置Content-Type并发送 JSON。 - 自定义体 (
body)：最灵活，手动构建请求体内容。
模板引擎结合了 Go Template 与 GJSON 路径语法。请求模板中可用 {{.args.xxx}} 引用参数，{{.config.xxx}} 引用配置项；响应模板则利用 GJSON 提取 JSON 字段，并支持 if、range 等控制结构进行数据清洗。
实战示例
内置服务配置
若直接使用平台内置的 MCP 服务（如搜索），配置极为简洁：
server:
