Higress 实战：将 REST API 转换为 MCP Server 工具

此外，还可以配置请求头 (headers) 和请求 URL (url)。

响应模板 (Response Template)

HTTP 返回后，我们需要将其转换为 AI 能理解的格式。使用 GJSON 路径语法访问 JSON 响应字段，并结合 Go 模板函数（如 add, upper）或控制结构（if, range）进行转换。

模板语法实战

配置中大量使用了 GJSON Template 语法，结合了 Go 模板和 GJSON 路径。理解这一点能让你的配置更灵活。

• 访问配置值: {{.config.字段名}}
• 访问工具参数: {{.args.参数名}}
• GJSON 路径示例:
  • 点表示法：address.city
  • 数组索引：users.0.name
  • 数组过滤：users.#(age>=30)#.name

在实际使用中，如果参数较多，建议优先使用 argsToJsonBody 或 argsToUrlParam 来简化配置，除非你有特殊的格式需求。

配置示例

1. 使用内置 MCP Server

如果你使用的是 Higress 内置的服务（如搜索），配置非常简单：

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

2. 转换高德地图 API

这是一个典型的 REST-to-MCP 场景。我们将高德地理编码接口转换为 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
        argsToUrlParam: true

通过这个配置，AI Agent 就可以直接调用 maps-geo 工具来获取地理位置信息了。任何 REST API 都可以通过类似的简单配置转换为 MCP Server，无需编写额外的业务代码，极大地提升了集成效率。

更多文档请查看：Higress MCP Server