利用 Higress MCP Server 插件将 REST API 转为 AI 工具

1. argsToFormBody：参数以 application/x-www-form-urlencoded 编码。
2. argsToUrlParam：参数作为查询字符串追加到 URL。
3. argsToJsonBody：参数直接作为 JSON Body 发送。
4. body：手动构建请求体，灵活性最高。

模板语法说明

配置中大量使用 GJSON Template 语法，结合了 Go 模板与 GJSON 路径。

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

示例路径：

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

配置实战示例

1. 使用内置 MCP Server

如果是内置服务，配置非常简洁：

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

2. 转换高德地图 API

下面是一个将高德地理编码 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

通过上述配置，AI Agent 即可根据自然语言指令自动构造请求并获取结果。这种模式极大地提升了开发效率，让任何 REST API 都能轻松接入 AI 生态。