将现有 REST API 转换为 MCP Server工具 -higress

Ne0inhk

— 5 min read
将现有 REST API 转换为 MCP Server工具 -higress

Higress 是一款云原生 API 网关，集成了流量网关、微服务网关、安全网关和 AI 网关的功能。
它基于 Istio 和 Envoy 开发，支持使用 Go/Rust/JS 等语言编写 Wasm 插件。
提供了数十个通用插件和开箱即用的控制台。
Higress AI 网关支持多种 AI 服务提供商，如 OpenAI、DeepSeek、通义千问等，并具备令牌限流、消费者鉴权、WAF 防护、语义缓存等功能。

MCP Server 插件配置

higress

功能说明

  • mcp-server 插件基于 Model Context Protocol (MCP)，专为 AI 助手设计，定义了 AI 模型与外部工具和资源交互的标准方式。
  • 功能特点：
    1. 无需编写代码：将现有 REST API 转换为 AI 助手可调用的工具。
    2. 统一认证、鉴权、限流和可观测性：利用 Higress 网关提供的能力，确保安全性和性能。
    3. 快速构建和部署：通过 Higress 插件机制，快速添加新的 MCP Server。

运行属性

  • 插件执行阶段：默认阶段
  • 插件执行优先级：30

配置字段

Server 配置

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

REST-to-MCP 工具配置

字段名数据类型填写要求默认值描述
toolsarray of object选填[]REST-to-MCP 工具配置列表。
tools[].namestring必填-工具名称。
tools[].descriptionstring必填-工具功能描述。
tools[].argsarray of object必填[]工具参数定义。
tools[].args[].namestring必填-参数名称。
tools[].args[].descriptionstring必填-参数描述。
tools[].args[].typestring选填string参数类型（string、number、integer、boolean、array、object）。
tools[].args[].requiredboolean选填false参数是否必需。
tools[].args[].defaultany选填-参数默认值。
tools[].args[].enumarray选填-参数允许的值列表。
tools[].args[].itemsobject选填-数组项的模式（当 type 为 array 时）。
tools[].args[].propertiesobject选填-对象属性的模式（当 type 为 object 时）。
tools[].requestTemplateobject必填-HTTP 请求模板。
tools[].requestTemplate.urlstring必填-请求 URL 模板。
tools[].requestTemplate.methodstring必填-HTTP 方法（如 GET、POST 等）。
tools[].requestTemplate.headersarray of object选填[]请求头模板。
tools[].requestTemplate.headers[].keystring必填-请求头名称。
tools[].requestTemplate.headers[].valuestring必填-请求头值模板。
tools[].requestTemplate.bodystring选填-请求体模板（与 argsToJsonBody、argsToUrlParam、argsToFormBody 互斥）。
tools[].requestTemplate.argsToJsonBodyboolean选填false参数直接作为 JSON 请求体（与 body、argsToUrlParam、argsToFormBody 互斥）。
tools[].requestTemplate.argsToUrlParamboolean选填false参数作为查询参数添加到 URL 中（与 body、argsToJsonBody、argsToFormBody 互斥）。
tools[].requestTemplate.argsToFormBodyboolean选填false参数以 application/x-www-form-urlencoded 格式编码在请求体中（与 body、argsToJsonBody、argsToUrlParam 互斥）。
tools[].responseTemplateobject必填-HTTP 响应转换模板。
tools[].responseTemplate.bodystring必填-响应体转换模板。

参数类型支持

  • 支持多种参数类型，用于更精确地定义工具参数：
    • string：字符串类型（默认）。
    • number：数字类型（浮点数）。
    • integer：整数类型。
    • boolean：布尔类型（true/false）。
    • array：数组类型，使用 items 字段定义数组元素的模式。
    • object：对象类型，使用 properties 字段定义对象属性的模式。

请求参数传递方式

  • 支持四种请求参数传递方式，这些选项是互斥的：

argsToFormBody：参数以 application/x-www-form-urlencoded 格式编码在请求体中，并自动添加相应的 Content-Type 头。

requestTemplate:argsToFormBody:true

argsToUrlParam：参数作为查询参数添加到 URL 中。

requestTemplate:argsToUrlParam:true

argsToJsonBody：参数直接作为 JSON 对象发送到请求体中，并自动添加 Content-Type: application/json; charset=utf-8 头。

requestTemplate:argsToJsonBody:true

body：手动构建请求体，最灵活的方式。

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

模板语法

  • 使用 GJSON Template 语法，结合了 Go 模板和 GJSON 路径语法。
  • 请求模板：
    • 访问配置值：{{.config.字段名}}
    • 访问工具参数：{{.args.参数名}}
  • 响应模板：
    • 使用 GJSON 路径语法访问 JSON 响应字段。
    • 使用模板函数（如 add、upper、lower 等）。
    • 使用控制结构（如 if、range 等）。
  • GJSON 路径语法：
    • 点表示法：address.city
    • 数组索引：users.0.name
    • 数组迭代：users.#.name
    • 数组过滤：users.#(age>=30)#.name
    • 修饰符：users.@reverse.#.name
    • 多路径：{name:users.0.name,count:users.#}
    • 转义字符：path.with\.dot

配置示例

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

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

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

通过 MCP Server，您可以快速为 AI Agent 添加各种数据源支持，提高开发效率。任何 REST API 都可以通过简单的配置转换为 MCP Server，无需编写额外的代码。

Read more

Java 程序员快速入门 Python：常见语法对照 + 常用库映射

Java 程序员快速入门 Python：常见语法对照 + 常用库映射

目录 一、这篇文章怎么用 二、语法对照总览 三、最常用语法对照（详细） 四、函数、类、对象对照 五、常用集合与写法对照 六、常用库映射（超实用） 七、常用库对照示例 八、Java 思维迁移到 Python 的小技巧 九、常见坑（直白版） 结语 补充说明 一、这篇文章怎么用 你会 Java，这篇文章就按“Java 写法 → Python 写法 → 一句话解释”来讲，并补上常用库映射。看完就能写出一份能跑的 Python 代码。 二、语法对照总览 * for (int i=0;

By Ne0inhk
Python 包管理工具 UV 功能介绍及安装

Python 包管理工具 UV 功能介绍及安装

pip install uv 是用于安装 UV（一个高性能 Python 包管理工具）的命令。以下是详细解释： 1. UV 是什么？ * UV 是由 Astral 团队开发的 Python 工具，旨在替代传统的 pip、pip-tools、virtualenv 等工具，提供更快的依赖解析和安装速度（比 pip 快 10-100 倍）。 * 它集成了包管理、虚拟环境管理、依赖锁定等功能，兼容 pip 的命令和 requirements.txt 文件。 2. 命令作用 * pip install uv 通过 Python 的包管理器 pip 安装 UV

By Ne0inhk

用 Python 30 分钟做出自己的记事本

🌟 《零基础手把手：用 Python 30 分钟做出自己的记事本》 —— 不是照抄代码，而是理解每行代码的「灵魂」 🧩 第一步：为什么我们需要「基础窗口」？（新手必懂！） ❌ 常见错误：直接写 window.show() 但窗口不显示？ ✅ 正确逻辑：程序运行流程图 启动程序 创建应用对象 创建窗口 显示窗口 进入事件循环 📝 代码详解（逐行解释）： import sys # 必须！用于接收系统参数（比如文件路径）from PyQt6.QtWidgets import QApplication, QMainWindow # 从PyQt库导入两个核心组件# 1️⃣ 创建应用对象（灵魂！所有PyQt程序必须有） app = QApplication(sys.argv)# sys.argv = 系统传递的命令行参数（比如打开的文件名）

By Ne0inhk
282道Python面试八股文（答案、分析和深入提问）整理

282道Python面试八股文（答案、分析和深入提问）整理

1. 请解释Python中的模块和包。 回答 在Python中，模块和包是组织代码的重要工具，它们有助于代码的重用和结构化。 模块 (Module) 模块是一个包含Python代码的文件，通常以 .py 作为文件扩展名。模块可以定义函数、类和变量，也可以包含可执行的代码。通过模块，可以将相关的功能分组到一个文件中，从而使得代码更加结构化和可维护。 创建和使用模块 使用模块：在其他Python文件或解释器中，可以使用 import 语句导入模块： import mymodule print(mymodule.greet("Alice"))print(mymodule.pi) 创建模块：你可以创建一个Python文件（例如 mymodule.py），并在其中定义函数或变量： # mymodule.pydefgreet(name):returnf"Hello, {name}!" pi

By Ne0inhk