Higress 将 REST API 转换为 MCP Server 工具配置

Higress 将 REST API 转换为 MCP Server 工具配置 | 极客日志

字段名	数据类型	填写要求	默认值	描述
`server.name`	string	必填	-	MCP Server 的名称。如果是内置 MCP Server（如 quark-search），只需配置此字段；如果是 REST-to-MCP 场景，此字段可以自定义。
`server.config`	object	选填	`{}`	MCP Server 配置，如 API 密钥等。
`server.allowTools`	array of string	选填	-	允许调用的工具列表。如果不指定，则允许所有工具。

字段名	数据类型	填写要求	默认值	描述
`tools`	array of object	选填	`[]`	REST-to-MCP 工具配置列表。
`tools[].name`	string	必填	-	工具名称。
`tools[].description`	string	必填	-	工具功能描述。
`tools[].args`	array of object	必填	`[]`	工具参数定义。
`tools[].args[].name`	string	必填	-	参数名称。
`tools[].args[].description`	string	必填	-	参数描述。
`tools[].args[].type`	string	选填	`string`	参数类型（`string`、`number`、`integer`、`boolean`、`array`、`object`）。
`tools[].args[].required`	boolean	选填	`false`	参数是否必需。
`tools[].args[].default`	any	选填	-	参数默认值。
`tools[].args[].enum`	array	选填	-	参数允许的值列表。
`tools[].args[].items`	object	选填	-	数组项的模式（当 `type` 为 `array` 时）。
`tools[].args[].properties`	object	选填	-	对象属性的模式（当 `type` 为 `object` 时）。
`tools[].requestTemplate`	object	必填	-	HTTP 请求模板。
`tools[].requestTemplate.url`	string	必填	-	请求 URL 模板。
`tools[].requestTemplate.method`	string	必填	-	HTTP 方法（如 `GET`、`POST` 等）。
`tools[].requestTemplate.headers`	array of object	选填	`[]`	请求头模板。
`tools[].requestTemplate.headers[].key`	string	必填	-	请求头名称。
`tools[].requestTemplate.headers[].value`	string	必填	-	请求头值模板。
`tools[].requestTemplate.body`	string	选填	-	请求体模板（与 `argsToJsonBody`、`argsToUrlParam`、`argsToFormBody` 互斥）。
`tools[].requestTemplate.argsToJsonBody`	boolean	选填	`false`	参数直接作为 JSON 请求体（与 `body`、`argsToUrlParam`、`argsToFormBody` 互斥）。
`tools[].requestTemplate.argsToUrlParam`	boolean	选填	`false`	参数作为查询参数添加到 URL 中（与 `body`、`argsToJsonBody`、`argsToFormBody` 互斥）。
`tools[].requestTemplate.argsToFormBody`	boolean	选填	`false`	参数以 `application/x-www-form-urlencoded` 格式编码在请求体中（与 `body`、`argsToJsonBody`、`argsToUrlParam` 互斥）。
`tools[].responseTemplate`	object	必填	-	HTTP 响应转换模板。
`tools[].responseTemplate.body`	string	必填	-	响应体转换模板。

requestTemplate:
  argsToFormBody: true

requestTemplate:
  argsToUrlParam: true

requestTemplate:
  argsToJsonBody: true

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

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

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

Higress 将 REST API 转换为 MCP Server 工具配置

功能说明

运行属性

配置字段

Server 配置

REST-to-MCP 工具配置

参数类型支持

请求参数传递方式

模板语法

配置示例

使用内置 MCP Server 示例：配置 quark-search

基础配置示例：转换高德地图 API

更多推荐文章

相关免费在线工具

Higress 将 REST API 转换为 MCP Server 工具配置

功能说明

运行属性

配置字段

Server 配置

REST-to-MCP 工具配置

参数类型支持

请求参数传递方式

模板语法

配置示例

使用内置 MCP Server 示例：配置 quark-search

基础配置示例：转换高德地图 API

微信扫一扫，关注极客日志

更多推荐文章

相关免费在线工具