使用 Higress 将 REST API 转换为 MCP Server 工具

支持多种参数类型以精确描述工具输入，包括字符串、数字、布尔值、数组及对象。请求参数传递有四种互斥方式：

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

示例：

requestTemplate:
  argsToJsonBody: true

手动构建 Body 示例：

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

模板语法

采用 GJSON Template 语法，结合 Go 模板与 GJSON 路径。

• 访问配置：{{.config.字段名}}
• 访问参数：{{.args.参数名}}
• GJSON 路径：支持点表示法、数组索引、迭代及过滤，如 users.#(age>=30)#.name

实战配置示例

内置 Server 示例

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

高德地图 API 转换

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 直接调用您的业务接口，无需额外开发代码，显著提升集成效率。