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

示例：手动构建请求体时可使用模板语法。

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

模板语法

配置采用 GJSON Template 语法，结合 Go 模板与 GJSON 路径：

• 访问配置：{{.config.字段名}}
• 访问参数：{{.args.参数名}}
• 响应处理：使用 GJSON 路径访问 JSON 字段，支持控制结构（if/range）及函数（add/upper/lower）。

常用 GJSON 路径示例：

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

配置示例

内置 Server 示例

直接使用内置的搜索服务：

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

REST API 转换示例

将高德地图地理编码 API 转换为 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

通过上述配置，任何 REST API 都能快速成为 AI Agent 的数据源，无需编写额外代码即可实现集成。