Higress 云市场 API 转 MCP 实战taobao-hot-words 淘宝热词 MCP 服务器配置全解【免费下载链接】higress AI Gateway | AI Native API Gateway项目地址: https://gitcode.com/GitHub_Trending/hi/higress本文以 Higress 官方内置的taobao-hot-wordsMCP 服务器为主线完整讲解阿里云云市场 API 如何通过 REST-to-MCP 机制无缝转化为 AI 可调用的 MCP 工具从 API 订阅与 AppCode 获取到mcp-server.yaml中请求模板、响应模板的逐项配置再到 Higress MCP Server 插件底层渲染引擎的实现原理帮助读者掌握零代码将存量 REST API 托管为 MCP 工具的完整方案。什么是云市场 API MCP 服务阿里云云市场是生态伙伴的交易服务平台致力于为合作伙伴提供覆盖上云、商业化和售卖的全链路服务帮助客户高效获取、部署和管理优质生态产品。云市场的 API 服务涵盖以下几个类目应用开发、身份验证与金融、车辆交通与物流、企业服务、短信与运营商、AI 应用与 OCR、生活服务。云市场 API 依托 Higress 提供 MCP 服务您只需在云市场完成订阅并获取 AppCode再通过 Higress MCP Server 进行配置即可将云市场 API 无缝集成为 MCP 工具供 AI 助手直接调用。这套模式的关键在于——MCP 工具本身无需编写一行 Go 代码仅凭一份声明式 YAML 即可完成 REST API 到 MCP 工具的转换这正是 Higress REST-to-MCP 能力的典型应用。前置准备订阅 API 并获取 AppCode在使用云市场 API MCP 服务前需要完成以下步骤订阅 API进入云市场 API 详情页淘宝热词对应的云市场 API 商品编号为cmapi022144订阅该 API。可以优先使用免费试用。获取并配置 AppCode前往云市场用户控制台使用阿里云账号登录后查看已订阅 API 服务的 AppCode并配置到 Higress MCP Server 的配置中。注意在阿里云市场订阅 API 服务后您将获得 AppCode。对于您订阅的所有 API 服务此 AppCode 是相同的——您只需使用这一个 AppCode 即可访问所有已订阅的 API 服务。关注可用额度云市场用户控制台会实时展示已订阅的预付费 API 服务的可用额度。如免费试用额度已用完可以选择重新订阅。AppCode 是后续所有配置中唯一的凭据在mcp-server.yaml中通过server.config.appCode字段注入。taobao-hot-words 服务器功能简介taobao-hot-words服务器主要服务于电商平台上的商家及运营者通过提供淘宝站内搜索关键词排名查询的功能来辅助决策。它能够根据用户的实时搜索频率来处理并分析数据从而让商家能够掌握特定关键词在市场中的表现情况包括但不限于其排名、分布特征等重要信息。此外还支持用户指定任意关键词并返回该词及其相关联度最高的前 10 个关键词列表按相关性从高到低排序展示结果。此功能对于优化商品标题、提升搜索可见度等方面具有重要作用。该服务器的接口定义同时以 OpenAPI 3.0.1 规范维护在 api.json 中服务标题为淘宝热词版本1.0.0唯一路径为GET /tbhot10请求主机为http://tbhot.market.alicloudapi.com路径摘要明确指出其核心能力查询用户输入关键词在全站的搜索排名以及与该关键词在全站关联度最高的 TOP 10 关键词按降序排列输出。工具详解淘宝热词用途与使用场景作为一款专注于淘宝平台内部搜索行为分析的工具淘宝热词能够帮助商家或开发者了解特定词汇在淘宝网上的流行程度与趋势变化。通过分析这些数据用户可以洞察消费者兴趣点的变化规律为产品推广策略调整提供依据。典型使用场景包括当需要评估某个新产品名称或者营销活动口号是否足够吸引目标客户群时在制定 SEO搜索引擎优化计划之前希望获取更多关于潜在热门词汇的信息希望定期监控某些关键业务术语在市场上的表现如何以便及时作出反应寻找灵感以创造新的广告标语或改善现有文案的效果。参数说明参数名是否必填类型说明key必填string用户想要查询的具体关键词即淘宝站内搜索的查询词从 api.json 的 OpenAPI 定义看key位于 query 参数位置in: query示例值为薰衣草。请求模板URL:http://tbhot.market.alicloudapi.com/tbhot10方法: GET头部信息:Authorization: 使用 APP Code 进行身份验证实际配置中格式为APPCODE {{.config.appCode}}X-Ca-Nonce: 用于防止重放攻击的安全令牌值为随机生成的 UUID由模板函数{{uuidv4}}在每次请求时动态生成。响应结构goodsList包含与查询关键词相关的商品关键词列表数组形式存储goodsList[]其中每个元素都是一个字符串代表单个条目按关联度降序排列key显示最初提交给 API 的实际查询关键字status表示请求状态的代码如01表示成功time记录了 API 响应的时间戳。以薰衣草为例OpenAPI 规范中给出的示例响应如下{ key: 薰衣草, goodsList: [ 薰衣草精油, 薰衣草干花, 薰衣草香包, 薰衣草纯露, 薰衣草盆栽, 薰衣草枕头, 薰衣草洗衣液, 薰衣草小熊, 薰衣草香水, 薰衣草沐浴露 ], status: 01, time: 1508190904000 }mcp-server.yaml 完整配置解析整个 MCP 服务器由一份声明式 YAML 完整定义见 mcp-server.yaml全文如下server: name: taobao-hot-words config: appCode: tools: - name: taobao-hot-words description: 淘宝站内搜索关键词排名查询工具。对淘宝全站所有搜索关键词根据用户实时搜索频度进行处理协助商家全面掌控搜索关键词近期的市场排名分布特征等。可根据用户输入的关键词 查询出该关键词在全站的搜索排名以及和该关键词在全站关联度最高的 TOP 10 关键词按降序排列输出。 args: - name: key description: 关键词 type: string required: true position: query requestTemplate: url: http://tbhot.market.alicloudapi.com/tbhot10 method: GET headers: - key: Authorization value: APPCODE {{.config.appCode}} - key: X-Ca-Nonce value: {{uuidv4}} responseTemplate: prependBody: | # API Response Information Below is the response from an API call. To help you understand the data, Ive provided: 1. A detailed description of all fields in the response structure 2. The complete API response ## Response Structure Content-Type: application/json - **goodsList**: 商品列表 (Type: array) - **goodsList[]**: Items of type string - **key**: 查询关键字 (Type: string) - **status**: 状态码 (Type: string) - **time**: 响应时间 (Type: string) ## Original Response各配置项的作用如下server 段服务器身份与全局配置name: taobao-hot-wordsMCP 服务器名称。Higress MCP Server 插件通过路由中的服务器名称识别请求应交给哪个 MCP 服务器处理因此部署到网关时请求路径中的服务器名必须与此完全一致config.appCode云市场 AppCode 的占位符。实际部署时填入在云市场用户控制台获取的 AppCode。同一个 AppCode 可复用于所有已订阅的云市场 API 服务。tools 段工具定义与参数name与descriptionMCP 协议tools/list返回给 AI 客户端的工具标识与描述。描述直接决定了 AI 何时会选择调用该工具因此写入了完整的业务语义全站排名 TOP 10 关联关键词 降序输出args定义工具入参key为必填字符串position: query表明它会被拼接到 HTTP 请求的 query string 中最终生成形如http://tbhot.market.alicloudapi.com/tbhot10?key薰衣草的完整 URL。requestTemplate 段请求构造url与method目标 API 端点GET /tbhot10headersAuthorization: APPCODE {{.config.appCode}}——使用 GJSON Template 语法引用server.config中的 AppCode完成云市场要求的 APP Code 鉴权X-Ca-Nonce: {{uuidv4}}——uuidv4是 GJSON Template 内置的 Sprig 模板函数之一每次工具调用时随机生成一个 UUID满足云市场 API 防重放要求。responseTemplate 段面向 AI 的响应整形prependBody会在原始 API 响应之前拼接一段结构化说明文本内容包括响应字段的完整描述goodsList/key/status/time各自的类型与含义以及## Original Response分隔标记其后紧跟原始 JSON。从源码实现看rest_server.go 中Result处理逻辑当配置了PrependBody/AppendBody时最终返回给 AI 的内容为PrependBody 原始响应 AppendBody的直接拼接。这种先解释结构、再给原始数据的方式能显著提升大模型对工具返回结果的理解与引用质量。底层实现原理REST-to-MCP 是如何工作的从源码结构看mcp-server.yaml这类声明式配置由 Higress MCP Server 插件内置的 REST-to-MCP 引擎解析执行核心实现在 rest_server.goRestToolRequestTemplate结构体定义了url、method、headers、body等字段工具初始化时即通过 Go template 预解析 URL 模板见源码中template.New(url).Funcs(templateFuncs()).Parse(t.RequestTemplate.URL)每次工具调用时引擎以.config.*服务器配置、.args.*AI 传入的工具参数作为模板上下文渲染出最终请求随后发起真实 HTTP 调用并套用响应模板模板引擎为 GJSON Template融合了 Go 模板语法与 GJSON 路径语法并内置全部 Sprig 函数70 个本文配置用到的.config.appCode、.args.key、{{uuidv4}}均属于该语法体系。这一能力是所有 Higress MCP 服务器插件内置的可以基于 all-in-one 插件统一使用——all-in-one 插件将多个 MCP 服务器的逻辑打包进同一个 WASM 二进制降低网关上部署多个插件的开销。完整的 REST-to-MCP 编写指南见 MCP 服务器实现指南其中还包含body模板渲染responseTemplate.body、allowTools工具白名单、GJSON 路径语法过滤、修饰符、多路径等等进阶能力。部署与验证将taobao-hot-words接入 Higress 的流程为将上述mcp-server.yaml中的server.config.appCode替换为真实 AppCode将该 MCP 服务器注册到 Higress MCP Server 插件可使用内置 all-in-one 插件承载此 REST-to-MCP 配置确保请求路由中的服务器名与server.nametaobao-hot-words一致验证方式通过 MCP 客户端如接入大模型的 Agent 框架发现工具列表应能看到名为taobao-hot-words、参数为key的工具发起工具调用例如key薰衣草预期返回含goodsListTOP 10 关联关键词、key、status、time字段的响应且响应前携带字段说明文本若返回鉴权类错误优先核对 AppCode 是否正确、该 API 订阅额度是否已用尽可在云市场用户控制台查看可用额度。适用前提MCP 服务器插件需要 Higress 2.1.0 或更高版本才能使用云市场 API 的可用性、额度与配额以阿里云云市场控制台实时展示为准。小结taobao-hot-words是一个典型的存量云市场 API 声明式 YAML转化为 MCP 工具的工程样本业务价值淘宝站内搜索排名与 TOP 10 关联词查询由云市场 API 提供AI 化改造则由 Higress 的 REST-to-MCP 机制完成。整套方案中开发者需要维护的只有mcp-server.yaml一个文件——参数定义、AppCode 鉴权、防重放 UUID、面向大模型的响应整形全部在其中声明式表达这也是 Higress 将云市场七大门类 API 批量 MCP 化的通用范式。【免费下载链接】higress AI Gateway | AI Native API Gateway项目地址: https://gitcode.com/GitHub_Trending/hi/higress创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考