Higress 网关实战：REST API 转 MCP Server 工具配置指南

每个参数还可以设置 required（是否必需）、default（默认值）以及 enum（枚举值），帮助 AI 更准确地生成参数。

请求模板 (requestTemplate)

这里决定了如何把 AI 生成的参数变成真实的 HTTP 请求。支持四种传递方式，它们是互斥的：

1. JSON Body (argsToJsonBody: true)：自动添加 Content-Type: application/json，参数直接转为 JSON 体。
2. URL Params (argsToUrlParam: true)：参数追加到 URL 查询串中。
3. Form Data (argsToFormBody: true)：以 application/x-www-form-urlencoded 格式编码。
4. 手动构建 (body)：最灵活，使用模板语法完全控制请求体内容。

响应模板 (responseTemplate)

AI 通常只关心结果，我们需要用 GJSON 路径语法提取关键信息返回给模型。例如 {{.body.data.result}}。

模板语法与实战技巧

Higress 使用 GJSON Template 语法，结合了 Go 模板和 GJSON 路径。这比纯正则强大得多。

• 访问参数：{{.args.参数名}}
• 访问配置：{{.config.字段名}}
• 处理响应：使用 GJSON 路径如 users.#(age>=30)#.name 进行过滤。

注意：在手动构建 body 时，可以使用 toJson 函数将复杂对象序列化为 JSON 字符串。

requestTemplate:
  body: |
    {
      "query": "{{.args.query}}",
      "filters": {{toJson .args.filters}},
      "options": { "limit": {{.args.limit}} }
    }

配置示例

1. 内置服务：Quark Search

如果直接使用内置的搜索服务，配置非常简单：

server:
  name: "quark-search"
  config:
    apiKey: "xxxx"

2. 自定义 REST：高德地图 API

这是一个典型的 REST-to-MCP 场景。我们将高德地理编码接口包装成一个工具。

server:
  name: rest-amap-server
  config:
    apiKey: your-api-key-here
  tools:
    - name: maps-geo
      description: "将详细的结构化地址转换为经纬度坐标。支持对地标性名胜景区、建筑物名称解析为经纬度坐标"
      args:
        - name: address
          description: "待解析的结构化地址信息"
          type: string
          required: true
        - name: city
          description: "指定查询的城市"
          type: string
          required: false
        - name: output
          description: "输出格式"
          type: string
          enum:
            - json
            - xml
          default: "json"
      requestTemplate:
        url: "https://restapi.amap.com/v3/geocode/geo"
        method: GET
        argsToUrlParam: true

在这个例子中，我们使用了 argsToUrlParam: true，因为高德接口主要依赖查询参数。AI 会根据 args 的定义自动生成正确的 URL 请求。

总结

通过 Higress 网关的 MCP Server 插件，开发者无需编写额外的后端代码，就能让 AI Agent 轻松接入各种数据源。无论是简单的查询接口还是复杂的业务逻辑，只要配置得当，都能转化为 AI 可调用的工具。这不仅降低了集成门槛，还借助网关能力保障了系统的安全性和稳定性。