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

【MySQL数据库基础】（三）MySQL 库的核心操作全解析：创建、修改、备份一条龙搞定

【MySQL数据库基础】（三）MySQL 库的核心操作全解析：创建、修改、备份一条龙搞定

前言         在 MySQL 的学习和实战中，数据库（库）的操作是最基础也是最核心的环节，无论是项目开发、数据管理还是运维维护，都绕不开库的创建、配置、修改、备份等一系列操作。很多刚接触 MySQL 的小伙伴容易在字符集、校验规则、备份恢复这些细节上踩坑，今天这篇文章就结合实战案例，把 MySQL 库的全套操作讲透，从基础语法到高级技巧，从避坑指南到实战演示，让你一文掌握 MySQL 库操作的精髓！ 一、创建数据库：基础语法与个性化配置         创建数据库是操作 MySQL 的第一步，看似简单的一句命令，背后却藏着字符集、校验规则的关键配置，选对配置能让后续的开发和数据管理少走很多弯路。 1. 核心创建语法         MySQL 中创建数据库的官方语法如下，其中大写部分为关键字，中括号[]内的为可选项，也是实际开发中需要重点关注的部分： CREATE DATABASE [IF NOT EXISTS]

By Ne0inhk
Flutter 组件 chopper_built_value 适配鸿蒙 HarmonyOS 实战：强类型网络层架构，构建不可变模型与高性能序列化闭环

Flutter 组件 chopper_built_value 适配鸿蒙 HarmonyOS 实战：强类型网络层架构，构建不可变模型与高性能序列化闭环

欢迎加入开源鸿蒙跨平台社区：https://openharmonycrossplatform.ZEEKLOG.net Flutter 组件 chopper_built_value 适配鸿蒙 HarmonyOS 实战：强类型网络层架构，构建不可变模型与高性能序列化闭环 前言 在鸿蒙（OpenHarmony）生态迈向大规模企业级应用、涉及高频网络数据交互、复杂业务模型及严苛运行时稳定性的背景下，如何确保网络请求返回的数据在进入 UI 层前具备绝对的类型安全，已成为衡量应用架构“护城河”深度的核心标准。在鸿蒙设备这类强调 AOT 极致性能与低容错率的环境下，如果应用依然依赖动态类型的 Map<String, dynamic> 进行数据传递，由于由于后端字段变更或类型溢出，极易由于由于运行时强转失败导致应用在关键业务路径上的红屏崩溃。 我们需要一种能够实现自动化代码生成、支持不可变（Immutable）模型且具备拦截器解耦能力的序列化粘合层。 chopper_built_value 为 Flutter 开发者引入了将 Chopper

By Ne0inhk
基于 Rust 与 DeepSeek 大模型的智能 API Mock 生成器构建实录：从环境搭建到架构解析

基于 Rust 与 DeepSeek 大模型的智能 API Mock 生成器构建实录：从环境搭建到架构解析

前言 在现代软件工程中，API 接口的开发与前端联调往往存在时间差。为了解耦前后端开发进度，Mock 数据（模拟数据）的生成显得尤为关键。传统的 Mock 数据生成依赖于静态 JSON 文件或简单的规则引擎，难以覆盖复杂的业务逻辑与语义关联。随着大语言模型（LLM）的兴起，利用 AI 根据 Schema 定义动态生成高保真的模拟数据成为可能。本文详细记录了使用 Rust 语言结合 DeepSeek-V3.2 模型构建智能 Mock 生成器的完整技术路径，涵盖操作系统层面的环境准备、Rust 工具链的深度配置、代码层面的异步架构设计以及编译期的版本兼容性处理。 第一部分：Linux 系统底层的构建环境初始化 Rust 语言的编译与链接过程高度依赖于底层的系统工具链。Rust 编译器 rustc 在生成二进制文件时，需要调用链接器（Linker）将编译后的对象文件（Object Files）与系统库（

By Ne0inhk
Flutter for OpenHarmony 实战：Flutter Rust Bridge — 极致计算性能方案

Flutter for OpenHarmony 实战：Flutter Rust Bridge — 极致计算性能方案

欢迎加入开源鸿蒙跨平台社区：https://openharmonycrossplatform.ZEEKLOG.net Flutter for OpenHarmony 实战：Flutter Rust Bridge — 极致计算性能方案 前言 在 Flutter for OpenHarmony 的高性能应用场景中（如：超大数据量加密、实时音视频处理、复杂物理模拟），Dart 的性能虽然出色，但在面对 CPU 密集型任务时，往往需要更底层的语言辅助。 Rust 凭借其内存安全与极致性能，成为了移动端计算的“无冕之王”。而 Flutter Rust Bridge (FRB) 则是将 Dart 与 Rust 缝合在一起的顶尖架构。它能自动生成繁琐的 FFI 胶水代码，并支持异步、流式传输以及复杂的对象映射。本文将带你在鸿蒙系统上构建一套“双擎驱动”

By Ne0inhk