Higress 网关：REST API 转 MCP Server 配置指南

请求参数传递方式

支持四种互斥的传递方式，根据目标 API 的特性选择：

1. argsToFormBody：以 application/x-www-form-urlencoded 编码，自动设置 Content-Type。
2. argsToUrlParam：参数追加到 URL 查询串中。
3. argsToJsonBody：参数作为 JSON 对象发送，自动添加 Content-Type: application/json。
4. body：手动构建请求体，灵活性最高。

示例：手动构建 JSON Body

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

模板语法

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

• 访问配置：{{.config.字段名}}
• 访问参数：{{.args.参数名}}
• 响应处理：支持 GJSON 路径（如 users.#(age>=30)#.name）及控制结构（if/range）。

实战示例

1. 使用内置 MCP Server

直接引用内置服务，只需配置名称和密钥：

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

2. 转换高德地图 API

这是一个典型的 REST-to-MCP 场景，将地理编码接口暴露给 AI Agent：

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 都能被快速封装为 AI 可用的工具，无需编写额外的适配代码。开发者只需关注业务逻辑与数据映射，即可高效扩展 AI Agent 的能力边界。