将现有 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

Python高级编程技术深度解析与实战指南

Python高级编程技术深度解析与实战指南

Python高级编程技术深度解析与实战指南 * 一、Python高级特性详解 * 1.1 装饰器(Decorators)深入解析 * 1.2 生成器(Generators)性能优势分析 * 1.3 上下文管理器应用场景 * 二、面向对象高级特性实战 * 2.1 魔术方法应用场景 * 2.2 抽象基类设计模式 * 三、并发编程深度解析 * 3.1 多线程vs多进程对比 * 3.2 异步编程执行流程 * 四、性能优化实战技巧 * 4.1 数据结构选择策略 * 4.2 缓存优化示例 * 五、现代Python特性详解 * 5.1 类型提示完整示例 * 5.2 数据类与普通类对比 * 六、测试驱动开发实践

By Ne0inhk
python核心语法（四）- 函数

python核心语法（四）- 函数

一.介绍 1.1 定义 函数是可重复调用的代码块，用来实现特定功能。 1.2 语法 def 函数名(参数1, 参数2, ...):        """函数文档字符串（可选，说明函数功能）"""        # 函数体：实现功能的代码        执行语句        return 返回值 # 可选，没有则默认返回None 1.3 注意事项 1.参数相关 默认参数：禁用列表 / 字典（可变对象），改用 None（内部初始化：lst = [] if lst is None else lst） 参数顺序：

By Ne0inhk
Python+vue3+djangod的KTV包厢服务管理系统

Python+vue3+djangod的KTV包厢服务管理系统

目录 * 摘要 * 开发技术路线 * 相关技术介绍 * 核心代码参考示例 * 结论 * 源码lw获取/同行可拿货,招校园代理 ：文章底部获取博主联系方式！ 摘要 该系统基于Python+Django+Vue3技术栈开发，旨在实现KTV包厢服务的数字化管理，提升运营效率与用户体验。后端采用Django框架构建RESTful API，提供数据持久化、权限控制及业务逻辑处理；前端使用Vue3组合式API开发响应式界面，配合Element Plus组件库实现高效交互。系统通过JWT实现用户认证，保障数据安全。 功能模块涵盖包厢管理、预订服务、消费结算及数据分析。包厢管理支持动态查询、状态更新（空闲/占用/清洁中）及设施维护记录；预订模块提供在线选房、时段冲突检测及订单提醒功能。结算系统集成多种支付方式（微信/支付宝/现金），自动生成消费明细与发票。数据分析模块通过ECharts可视化营收、客流趋势，辅助经营决策。 技术亮点包括WebSocket实时推送包厢状态变更、Redis缓存高频访问数据以提升响应速度，以及Nginx部署实现负载均衡。系统采用前后端分离架构

By Ne0inhk
解决“uv 无法识别为命令”问题：Windows 下 Python 工具安装后的路径配置方法

解决“uv 无法识别为命令”问题：Windows 下 Python 工具安装后的路径配置方法

目录 🚀解决“uv 无法识别为命令”问题：Windows 下 Python 工具安装后的路径配置方法 📌问题背景 ✅ 一、确认 uv 是否已安装 ✅ 二、临时使用 uv（快速绕过） ✅ 三、永久解决：将 uv 加入系统环境变量 步骤如下： 🔁 四、可选：为 uv 设置 PowerShell 别名 🧩 总结 📎附录：常见 Python 工具路径（以 Python 3.11 为例） 🚀解决“uv 无法识别为命令”问题：Windows 下 Python 工具安装后的路径配置方法 📌问题背景

By Ne0inhk