Higress MCP Server 插件配置指南
Higress 是一款云原生 API 网关，支持使用 Go/Rust/JS 等语言编写 Wasm 插件。其 AI 网关能力允许集成多种 AI 服务提供商，并具备令牌限流、消费者鉴权等功能。
功能概述
MCP Server 插件基于 Model Context Protocol (MCP)，专为 AI 助手设计，定义了 AI 模型与外部工具和资源交互的标准方式。核心优势在于无需编写代码即可将现有 REST API 转换为 AI 助手可调用的工具，同时利用网关统一处理认证、鉴权和限流。
配置详解
基础配置
| 字段名 | 数据类型 | 填写要求 | 默认值 | 描述 |
|---|---|---|---|---|
server.name | string | 必填 | - | MCP Server 名称。内置服务如 quark-search 只需此字段；REST-to-MCP 场景可自定义。 |
server.config | object | 选填 | {} | 服务器配置，例如 API 密钥。 |
server.allowTools | array of string | 选填 | - | 允许调用的工具列表，不指定则允许所有。 |
工具定义结构
在 tools 数组中定义具体的 REST 接口映射：
- name: 工具名称（必填）
- description: 工具功能描述（必填）
- args: 参数定义列表（必填），包含 name, description, type, required 等属性。
- requestTemplate: HTTP 请求模板（必填），定义 URL、Method 及参数传递方式。
- responseTemplate: 响应转换模板（必填），用于提取和格式化返回数据。
参数类型支持
支持多种参数类型以精确描述工具输入：
string: 字符串（默认）number: 浮点数integer: 整数boolean: 布尔值array: 数组，需配合items定义元素模式object: 对象，需配合properties定义属性模式
请求参数传递方式
以下四种方式互斥，根据目标 API 的规范选择其一：
- argsToFormBody: 参数编码为
application/x-www-form-urlencoded。 - argsToUrlParam: 参数追加到 URL 查询串。
- argsToJsonBody: 参数作为 JSON 对象发送，自动设置 Content-Type。
- body: 手动构建请求体，灵活性最高。
示例（手动构建 body）：
