Higress 云市场基金数据查询 MCP Server 接入与配置实战【免费下载链接】higress AI Gateway | AI Native API Gateway项目地址: https://gitcode.com/GitHub_Trending/hi/higress本篇技术指南围绕 Higress 开源仓库中fund-data-query这一基于阿里云 API 市场的基金数据查询 MCP Server 展开详细讲解如何通过 REST-to-MCP 零代码配置将云市场基金 API 快速封装为可供 AI Agent 调用的 MCP 工具。读完本文你将掌握云市场 AppCode 的申请与配置方法、14 个基金数据查询工具的参数与使用场景、REST-to-MCP 配置文件的结构与模板语法以及如何将本 MCP Server 部署到 Higress 网关供大模型应用调用。什么是云市场 API MCP 服务阿里云云市场是生态伙伴的交易服务平台为合作伙伴提供覆盖上云、商业化和售卖的全链路服务帮助客户高效获取、部署和管理优质生态产品。云市场的 API 服务涵盖应用开发、身份验证与金融、车辆交通与物流、企业服务、短信与运营商、AI 应用与 OCR、生活服务等多个类目。云市场 API 依托 Higress 提供 MCP 服务MCP 即 Model Context Protocol本质上是面向 AI 更友好的 API 协议使 AI Agent 能够更容易地调用各种工具和服务。你只需在云市场完成订阅并获取 AppCode通过 Higress MCP Server 进行配置即可无缝集成云市场 API 服务。Higress 可以统一处理工具调用的认证、鉴权、限流、观测等能力显著简化 AI 应用的开发与部署相关的 MCP Server 实现与部署方式可参考仓库中的 MCP 服务器实现指南。接入前的准备工作在使用云市场 API MCP 服务之前需要完成以下三步准备订阅 API进入基金数据查询 API 的详情页并订阅该 API建议优先使用免费试用额度进行功能验证。获取 AppCode 并配置前往云市场用户控制台使用阿里云账号登录后查看已订阅 API 服务的 AppCode并将其配置到 Higress MCP Server 的配置中。需要注意在阿里云市场订阅 API 服务后获得的 AppCode对于你订阅的所有 API 服务是相同的只需使用这一个 AppCode 即可访问所有已订阅的 API 服务。额度确认与续订云市场用户控制台会实时展示已订阅的预付费 API 服务的可用额度如果免费试用额度已用完可以选择重新订阅。从源码实现看AppCode 正是本 MCP Server 的唯一认证凭据在 mcp-server.yaml 中服务器配置只包含一个appCode字段所有工具的请求头都会携带Authorization: APPCODE {{.config.appCode}}以及防重放的X-Ca-Nonce请求头。MCP Server 功能简介该 MCP 服务器名为fund-data-query主要用于提供基金相关数据的查询服务。它通过一系列工具来实现对不同种类基金信息的获取包括在售基金列表、基金估值数据、基金公告、基金分红送配、历任经理、历史净值、持仓、收益排名、规模变化、费率、走势以及新发基金列表等。这些工具具备以下共同特征全部采用HTTP GET方法向指定 URL 发送请求均需要使用特定的应用代码appCode进行授权验证每个工具返回的数据格式均为JSON。与手写 WASM 插件实现工具不同本 MCP Server 采用 Higress 内置的REST-to-MCP能力无需编写任何 Go 代码仅通过声明式的 YAML 配置即可将 REST API 转换为 MCP 工具该能力内置于 all-in-one 插件所有 MCP 服务器均可使用。仓库中的 api.json 保存了这份云市场基金 API 的 OpenAPI 3.0 规范描述可作为接口参数与响应字段的权威参考。工具配置总览与请求模板解析完整的工具定义位于 mcp-server.yaml配置文件分为server与tools两大部分server: name: fund-data-query config: appCode: tools: - name: fund-list description: 在售基金列表 args: - name: limit description: 分页条数 type: string position: query - name: page description: 分页页码 type: string position: query requestTemplate: url: https://fund.market.alicloudapi.com/fundList 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. ...其配置要点如下server.nameMCP 服务器名称必须与部署时使用的服务器名称一致系统通过该名称识别由哪个 MCP 服务器处理请求server.config.appCode云市场 API 的认证凭据通过{{.config.appCode}}模板变量注入到请求头tools[].args每个工具声明的输入参数position: query表示参数以查询字符串方式拼接在 URL 上required: true标记必填参数requestTemplate构造 HTTP 请求的 URL、方法与头部。X-Ca-Nonce使用{{uuidv4}}模板函数为每次请求生成唯一 UUID用于防止请求重放responseTemplate.prependBody在原始 JSON 响应前追加一段面向 AI 的说明文本引导大模型理解响应结构 原始响应的数据组织方式。REST-to-MCP 的请求模板使用 GJSON Template 语法通过.config.fieldName访问配置值、.args.argName访问工具参数并内置了uuidv4等超过 70 个含 Sprig 函数集模板函数详见 MCP 服务器实现指南 中的模板语法章节。核心工具详解以下逐一说明该 MCP Server 暴露的 14 个基金查询工具工具名、接口路径均取自 mcp-server.yaml参数示例参考 api.json。在售基金列表fund-list用途获取当前市场上所有可购买基金的基本信息。使用场景当用户或系统需要展示最新的基金产品供选择时调用此接口获取最新数据。接口GET https://fund.market.alicloudapi.com/fundList参数说明limit每页显示条目数量示例值 10page当前查看页码示例值 1。两个参数均为可选参数。基金估值数据fund-guzhi用途提供单个基金的最新估值详情。使用场景适合个人投资者跟踪其持有的某只基金的表现情况。接口GET https://fund.market.alicloudapi.com/fundGuzhi参数说明fundcode必填需要查询的具体基金代码示例值 001707。基金公告数据fund-notice用途列出特定基金发布的所有官方通知或重要事项。使用场景帮助投资者及时了解所投资基金的重要变动信息。接口GET https://fund.market.alicloudapi.com/fundNotice参数说明fundcode必填目标基金代码示例值 150186limit返回结果的最大数量限制示例值 10page分页索引示例值 1。基金分红送配fund-bonus用途展示某个基金过去一段时间内的分红记录。使用场景对关注收益分配策略的投资者非常有用。接口GET https://fund.market.alicloudapi.com/fundBonus参数说明fundcode必填查询对象基金代码示例值 000263。基金历任经理fund-manager-history用途提供给定基金历史上管理过它的所有基金经理的信息。使用场景评估基金长期表现时考虑不同时间段内基金经理的影响。接口GET https://fund.market.alicloudapi.com/getFundManagerHistory参数说明fundcode必填特定基金的标识符示例值 001227。基金历史净值fund-history用途按时间周期查询基金的历史净值走势。接口GET https://fund.market.alicloudapi.com/fundHistory参数说明fundcode必填基金代码示例值 000263period可选时间周期取值1近一个月2近 3 个月3近 6 个月4近一年5近三年6近五年7今年以来8成立以来。响应结构依据 api.json返回 JSON 数组每个元素包含date数据日期如2022-09-21、totalValue累计净值如 4.047、fundCode基金代码、netValue单位净值如 3.77、dayOfGrowth日涨幅如 -0.95。基金基础数据查询fund-detail用途查询基金的基础资料信息。接口GET https://fund.market.alicloudapi.com/getFundDetail参数说明fundcode必填基金代码示例值 001227。基金持仓数据fund-hold用途查询基金的持仓明细。接口GET https://fund.market.alicloudapi.com/fundHold参数说明fundcode必填基金代码示例值 000263reportDate可选公告日期格式如2020-06-30,2020-03-31不传则默认返回最新一期。基金收益排名fund-rank用途查询基金的收益排名信息。接口GET https://fund.market.alicloudapi.com/fundRank参数说明fundcode必填基金代码示例值 000263。基金经理数据fund-manager用途查询当前管理基金的基本数据与经理信息。接口GET https://fund.market.alicloudapi.com/getFundManager参数说明fundcode必填基金代码示例值 001227。基金规模变化fund-asset用途查询基金规模的历史变化情况。接口GET https://fund.market.alicloudapi.com/fundAsset参数说明fundcode必填基金代码示例值 150186limit分页条数示例值 10page分页页码示例值 1。基金费率数据fund-rate用途查询基金的申购、赎回等费率信息。接口GET https://fund.market.alicloudapi.com/fundRate参数说明fundcode必填基金代码示例值 001707。基金走势数据fund-yield用途查询基金近三个月的历史走势数据。接口GET https://fund.market.alicloudapi.com/queryFundYield参数说明fundcode必填基金代码示例值 001227。新发基金列表fund-new用途列出最近发行的新基金产品。使用场景为寻找新投资机会的用户提供参考。接口GET https://fund.market.alicloudapi.com/fundNew参数说明limit单次请求最多返回的记录条数示例值 10page请求第几页的数据示例值 1saleStatus销售状态true为可售false为不可售README 中描述其默认值为 true配置中为可选参数。在 Higress 上部署与调用fund-data-query属于云市场类 REST-to-MCP 服务实际使用时可将其作为 MCP Server 插件配置到 Higress 网关。核心部署动作如下填写服务器配置将server.config.appCode替换为你从云市场用户控制台获取的 AppCode按需裁剪工具可选如果只想暴露部分能力可在tools列表保留需要的工具或通过插件配置中的allowTools白名单限制可调用的工具配置到网关将该 YAML 作为 Higress MCP Server 插件配置下发由 Higress 统一负责工具调用的认证、鉴权、限流与观测由 AI 助手消费MCP 服务器通过 Model Context Protocol 与 AI 助手通信AI Agent 会自动根据工具描述选择合适的基金数据工具进行调用。MCP Server 插件需要 Higress 2.1.0 或更高版本才能使用。如需自行构建或二次开发可参考 MCP Server Makefilemake SERVER_NAMEmcp-fund-data-query build可将服务器代码编译为 WASM 二进制make build-image/make build-push用于构建并推送 Docker 镜像。小结fund-data-query是 Higress 云市场 API MCP 生态中的一个典型示例通过一份 mcp-server.yaml 配置文件与一个云市场 AppCode即可将 14 个基金数据 REST 接口在售列表、估值、公告、分红、经理、历史净值、持仓、排名、规模、费率、走势、新发基金等零代码转换为 AI Agent 可直接调用的 MCP 工具。其请求模板中{{.config.appCode}}与{{uuidv4}}的组合使用也是理解 Higress REST-to-MCP 认证与防重放机制的最佳实践样本。读者可对照 api.json 的接口契约与 MCP 服务器实现指南 的模板语法将其扩展适用于云市场中的任何其他 API 服务。【免费下载链接】higress AI Gateway | AI Native API Gateway项目地址: https://gitcode.com/GitHub_Trending/hi/higress创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考