使用 Higress 将 REST API 转换为 MCP Server

参数类型支持

支持多种类型以精确描述工具参数：

• string：字符串（默认）。
• number：浮点数。
• integer：整数。
• boolean：布尔值。
• array：数组，需配合 items 定义元素模式。
• object：对象，需配合 properties 定义属性模式。

请求参数传递方式

以下选项互斥，根据接口需求选择一种：

1. argsToFormBody：参数以 application/x-www-form-urlencoded 编码，自动设置 Content-Type。

   requestTemplate:
     argsToFormBody: true
   

2. argsToUrlParam：参数作为查询参数追加到 URL。

   requestTemplate:
     argsToUrlParam: true
   

3. argsToJsonBody：参数作为 JSON 对象发送，自动添加 Content-Type: application/json; charset=utf-8。

   requestTemplate:
     argsToJsonBody: true
   

4. body：手动构建请求体，灵活性最高。

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

模板语法

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

• 访问配置：{{.config.字段名}}
• 访问参数：{{.args.参数名}}
• GJSON 路径：支持点表示法 (address.city)、数组索引 (users.0.name)、迭代 (users.#.name) 及过滤 (users.#(age>=30)#.name)。
• 函数与控制结构：支持 add, upper, if, range 等。

配置示例

内置 Server：quark-search

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

通过上述配置，任何 REST API 都能被转换为 MCP Server，让 AI Agent 轻松调用外部数据源，同时享受网关层面的安全与性能保障。