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

其中 tools[].args 支持多种类型，包括 string、number、integer、boolean、array 和 object。对于复杂结构，可使用 items 定义数组元素模式，或用 properties 定义对象属性。

请求参数传递方式

配置中支持四种互斥的参数传递方式，根据后端接口需求选择：

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

示例：手动构建请求体时，可以使用模板语法动态填充参数。

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

模板语法

配置中广泛使用了 GJSON Template 语法，结合了 Go 模板和 GJSON 路径解析能力。

• 访问配置：{{.config.字段名}}
• 访问参数：{{.args.参数名}}
• 响应解析：支持点表示法、数组索引、迭代及过滤表达式。

例如，提取用户列表中的姓名：

• 点表示法：address.city
• 数组迭代：users.#.name
• 条件过滤：users.#(age>=30)#.name

配置实战

场景一：使用内置 MCP Server

如果直接使用 Higress 内置的服务（如搜索），配置非常简洁：

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

场景二：转换高德地图 API

将现有的 REST API 转换为 AI 工具，需要详细定义参数和请求模板。以下是一个将结构化地址转为经纬度的示例：

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 直接调用企业内部的私有数据源，显著提升开发效率。