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

在 tools[].args 中，可以定义参数的类型和行为：

• name: 参数名称。
• description: 参数描述。
• type: 参数类型（string, number, integer, boolean, array, object）。
• required: 是否必需。
• default: 默认值。
• enum: 允许的值列表。
• items / properties: 用于数组或对象类型的子模式定义。

请求参数传递方式

支持四种请求参数传递方式，这些选项是互斥的，需根据目标 API 的要求选择：

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}} }
       }
   

模板语法

配置中使用的模板语法结合了 Go 模板和 GJSON 路径语法，非常强大。

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

配置示例

使用内置 MCP Server

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

基础配置示例：转换高德地图 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 都可以被快速转换为 MCP Server，让 AI Agent 能够直接调用外部数据源，无需编写额外的适配代码。