使用 Higress 将 REST API 转换为 MCP Server 工具

1. 内置服务配置

以 Quark 搜索为例，仅需指定名称与密钥：

server:
  name: "quark-search"
  config:
    apiKey: "your-api-key"

2. 自定义高德地图 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
        argsToUrlParam: true

模板语法要点

配置中大量使用了 GJSON Template 语法，结合了 Go 模板与 GJSON 路径特性。

• 访问参数: {{.args.参数名}}
• 访问配置: {{.config.字段名}}
• JSON 解析: 使用点表示法 address.city 或数组索引 users.0.name
• 高级过滤: 支持数组迭代 users.#.name 或条件过滤 users.#(age>=30)#.name

实际开发中，建议先在本地调试模板表达式，确认变量替换无误后再部署到网关。对于复杂的 JSON 响应转换，利用 toJson 函数可以方便地将对象序列化为字符串供后续处理。

通过上述配置，现有的 REST API 便能无缝融入 AI Agent 的工作流中，既保留了原有接口的稳定性，又赋予了 AI 调用业务数据的能力。