使用 Higress 将 REST API 转换为 MCP Server

请求与响应模板

这里使用了 GJSON Template 语法，结合了 Go 模板和 GJSON 路径。

请求参数怎么传？ 有四种互斥的方式，根据后端接口需求选择：

• 表单提交：argsToFormBody，自动加 application/x-www-form-urlencoded 头。
• URL 参数：argsToUrlParam，拼接到 URL 后面。
• JSON Body：argsToJsonBody，自动加 application/json 头。
• 手动构建：body，最灵活，适合复杂场景。

例如手动构建 JSON 请求体：

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

注意这里的 {{.args.xxx}} 是访问工具传入的参数，{{toJson ...}} 用于序列化对象。

响应怎么处理？ 同样用 GJSON 路径访问返回的 JSON 字段，配合模板函数（如 add、upper）和控制结构（if、range）进行清洗。

实战示例

1. 内置服务配置 如果是像 quark-search 这样的内置 MCP Server，配置很简单：

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

2. 转换高德地图 API 下面是一个将高德地理编码接口转换为 MCP 工具的完整配置。你可以看到如何通过 args 定义输入，再通过 requestTemplate 映射到 GET 请求。

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 就能直接调用这个工具获取地理位置信息，而无需你再去写适配层代码。这种模式极大地降低了 AI 应用接入外部数据的门槛。