基于 Higress 将 REST API 转换为 MCP Server 工具配置指南

请求模板 (requestTemplate)

这里需要定义如何构造 HTTP 请求。注意，以下四种传递方式是互斥的：

1. JSON Body (argsToJsonBody: true)：参数作为 JSON 对象发送，自动添加 Content-Type: application/json。
2. URL 参数 (argsToUrlParam: true)：参数拼接到 URL 查询串中。
3. Form Body (argsToFormBody: true)：参数以 application/x-www-form-urlencoded 编码。
4. 手动构建 (body)：最灵活的方式，使用模板语法手动拼接请求体。

示例：手动构建请求体时，可以使用 Go 模板语法处理参数。

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

响应模板 (responseTemplate)

用于转换后端返回的 HTTP 响应。支持 GJSON 路径语法访问 JSON 字段，以及模板函数（如 add, upper）和控制结构（if, range）。

常用 GJSON 路径示例：

• 点表示法：address.city
• 数组索引：users.0.name
• 数组过滤：users.#(age>=30)#.name

实战配置示例

1. 内置 Server 示例

如果你使用的是 Higress 内置的搜索服务，配置非常简单：

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

2. 转换高德地图 API

下面是一个将高德地图地理编码接口转换为 MCP 工具的完整配置。注意 YAML 缩进和引号的使用。

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

通过 MCP Server，你可以快速为 AI Agent 接入各种数据源。任何 REST API 都可以通过简单的配置转换为 MCP Server，无需编写额外的业务代码，从而显著提高开发效率。