基于 Higress MCP Server 插件转换 REST API 为 AI 工具

(注：requestTemplate 包含 url, method, headers, body 等详细子字段，具体见下方示例)

参数类型与传递方式

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

1. 表单提交 (argsToFormBody)：参数编码为 application/x-www-form-urlencoded，自动设置 Content-Type。
2. 查询参数 (argsToUrlParam)：参数追加至 URL 中。
3. JSON Body (argsToJsonBody)：参数作为 JSON 对象发送，自动设置 Content-Type: application/json。
4. 手动构建 (body)：最灵活的方式，直接定义请求体内容。

模板语法

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

• 访问配置：{{.config.字段名}}
• 访问参数：{{.args.参数名}}
• 响应处理：支持 GJSON 路径访问 JSON 字段，以及 add、upper 等函数和控制结构。

配置实战

内置服务示例

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

REST 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

通过 MCP Server，开发者无需编写额外代码，即可将任意 REST API 快速接入 AI Agent，显著提升开发效率。