基于 Higress 网关将 REST API 转换为 MCP Server 工具

Higress 采用 GJSON Template 语法，结合了 Go 模板和 GJSON 路径。

• 获取配置：{{.config.字段名}}
• 获取参数：{{.args.参数名}}
• 处理响应：支持点表示法、数组索引、过滤器等高级操作。例如 users.#(age>=30)#.name 可以筛选出年龄大于 30 的用户姓名。

配置示例

内置服务：Quark Search

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

server:
  name: "quark-search"
  config:
    apiKey: "your-api-key-here"

自定义服务：高德地图 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
        argsToUrlParam: true

通过这种方式，任何 REST API 都能快速接入 AI Agent，无需编写额外的适配代码，极大提升了开发效率。