基于 Higress 的云市场 API MCP 服务实战：企业专利查询（business-patent-query）
基于 Higress 的云市场 API MCP 服务实战企业专利查询business-patent-query【免费下载链接】higress AI Gateway | AI Native API Gateway项目地址: https://gitcode.com/GitHub_Trending/hi/higressHigress 作为 AI Native API Gateway内置 REST-to-MCP 能力可以把阿里云云市场的 REST API 零代码转换为可供 AI Agent 调用的 MCP 工具。本文以business-patent-query企业专利查询服务为完整案例从订阅 API、获取 AppCode、理解两个核心工具的参数与响应结构到剖析mcp-server.yaml配置模板与底层生成机制帮助读者掌握在 Higress 上快速接入云市场 API 的完整流程。一、背景什么是云市场 API MCP 服务阿里云云市场是生态伙伴的交易服务平台其 API 服务涵盖应用开发、身份验证与金融、车辆交通与物流、企业服务、短信与运营商、AI 应用与 OCR、生活服务等多个类目。云市场 API 依托 Higress 提供 MCP 服务只需在云市场完成订阅并获取 AppCode通过 Higress MCP Server 进行配置即可无缝集成云市场 API 服务。Higress 作为基于 Envoy 的 API 网关支持通过插件方式托管 MCP Server。MCPModel Context Protocol本质上是面向 AI 更友好的 API使 AI Agent 能够更容易地调用各种工具和服务。Higress 可以统一处理工具调用的认证、鉴权、限流、观测等能力简化 AI 应用的开发和部署参见 MCP 服务器实现指南。注意MCP Server 插件需要 Higress 2.1.0 或更高版本才能使用。二、准备工作订阅 API 与获取 AppCode使用企业专利查询服务前需要完成两步准备订阅 API进入 企业专利查询 API 详情页订阅该 API可以优先使用免费试用额度。获取 AppCode前往云市场用户控制台使用阿里云账号登录后查看已订阅 API 服务的 AppCode并配置到 Higress MCP Server 的配置中。需要特别注意的是在阿里云市场订阅 API 服务后获得的 AppCode对于所订阅的所有API 服务是相同的只需使用这一个 AppCode 即可访问所有已订阅的 API 服务。云市场用户控制台会实时展示已订阅的预付费 API 服务的可用额度如免费试用额度已用完可以重新订阅。三、服务功能与两大核心工具business-patent-query服务器专注于为企业或个人用户提供专利相关信息的服务。通过此服务用户可以搜索到特定技术领域内的所有相关专利这有助于避免侵犯他人的知识产权并为自身的研发活动指明方向。它包括两大核心功能专利信息列表检索与专利详情查看定义于 mcp-server.yaml。3.1 专利信息列表business-patent-query用途根据关键字如公司名称、社会统一信用代码、注册号等查找相关的专利列表。应用场景当需要对某一行业或公司的专利布局进行全面了解时使用也可用于市场调研、竞争对手分析等领域。参数说明参数类型必填默认值说明dtypestring否json返回的数据格式可选json或xmlkeywordstring是-搜索关键字公司名称、社会统一信用代码、注册号pageIndexinteger否第 1 页指定返回结果的页码pageSizeinteger否10每页显示的结果数量最大不超过 10 条该工具对应的底层 API 为GET /utn/ip/PatentPageByKey/V2其请求模板定义如下requestTemplate: url: http://icpatent.market.alicloudapi.com/utn/ip/PatentPageByKey/V2 method: GET headers: - key: Authorization value: APPCODE {{.config.appCode}} - key: X-Ca-Nonce value: {{uuidv4}}3.2 专利信息详情patent-detail用途基于已知的专利 ID获取单个专利的具体细节信息。应用场景适用于深入研究某一项具体的专利内容或是需要详细了解某项技术解决方案的情况。参数说明参数类型必填默认值说明dtypestring否json返回的数据格式可选json或xmlidinteger是-专利唯一标识符通常从「专利信息列表」接口返回的Id字段获得该工具对应的底层 API 为GET /utn/ip/PatentDetail请求模板与列表接口一致均通过Authorization: APPCODE {{.config.appCode}}头携带认证信息。四、部署配置mcp-server.yaml 深度解析企业专利查询服务的完整配置位于 mcp-server.yaml其顶层结构如下server: name: business-patent-query config: appCode: tools: - name: business-patent-query ... - name: patent-detail ...4.1 server 配置段nameMCP 服务器名称必须与 all-in-one 插件中mcp.AddMCPServer()注册的名称一致系统通过该字段识别由哪个 MCP Server 处理请求。config.appCode云市场订阅后获取的 AppCode通过模板变量{{.config.appCode}}注入到请求头中完成 API 认证。4.2 请求模板requestTemplate请求模板用于构造 HTTP 请求的 URL、头部和正文使用.config.fieldName访问服务器配置值如{{.config.appCode}}使用.args.argName访问工具参数如{{.args.keyword}}模板函数如{{uuidv4}}用于生成X-Ca-Nonce阿里云 API 网关要求的防重放随机数头。4.3 响应模板responseTemplate响应模板用于将 HTTP 响应转换为适合 AI 消费的格式。business-patent-query使用prependBody方式在原始响应前拼接一段 Markdown 格式的响应结构说明帮助 LLM 理解每个字段的含义随后附上原始响应内容。这是云市场 MCP 模板yunmarket-tmpl.yaml的典型写法先描述字段语义再给出数据让 AI 在解析时看图说话。4.4 可选白名单allowTools在部署时还可以通过allowTools配置工具白名单只有列出的工具才能被调用起到安全管控作用server: name: business-patent-query config: appCode: 你的AppCode allowTools: - business-patent-query - patent-detail五、响应数据结构详解5.1 专利信息列表响应列表接口/utn/ip/PatentPageByKey/V2的响应包含三个顶层字段dataobjectdata.Itemsarray专利列表每项包含Idinteger专利 ID作为详情查询的入参Titlestring标题ApplicationNumber/ApplicationDate申请号与申请日期PublicationNumber/PublicationDate公开号与公开日期AssigneeStringList申请人InventorStringList发明人Agency代理机构IPCList/IPCDescIPC 分类号与分类描述KindCodeDesc类别代码描述如发明LegalStatusDesc法律状态描述如授权。data.Pagingobject分页信息含PageIndex当前页码、PageSize每页显示条数、TotalRecords总记录数。orderNointeger订单号用于跟踪请求。statusCodeinteger状态码成功为1。statusMessagestring状态消息如请求成功。字段的完整定义与示例值可在 api.json 的 OpenAPI 3.0.1 规范中核对例如Id示例值为45233394、TotalRecords示例值为8842。5.2 专利信息详情响应详情接口/utn/ip/PatentDetail的响应在列表字段基础上进一步扩充data.Abstract摘要data.Agent代理人data.PrimaryExaminer/data.AssiantExaminer主审查员 / 辅助审查员data.AssigneestringList专利权人列表data.Cites/data.OtherReferences引用与其他引用data.PatentImage专利图片链接data.DocumentTypes文档类型data.PatentLegalHistoryarray法律状态变更历史每项含LegalStatus、LegalStatusDate、Descdata.LegalStatusDate法律状态日期。响应同样包含orderNo、statusCode、statusMessage元数据便于跟踪请求状态和解析数据。每个工具都提供了详细的请求模板和响应模板说明以确保开发者能够正确调用 API 并处理返回的数据。六、底层机制REST-to-MCP 与自动生成流程6.1 零代码的 REST-to-MCP 能力business-patent-query之所以只需要一份 YAML 配置而无需编写任何 Go 代码是因为 Higress 内置了 REST-to-MCP 能力它允许将任意 REST API 转换为 MCP 工具该能力内置于所有 MCP Server可基于 all-in-one 插件使用模板渲染基于 GJSON Template 库结合 Go 模板语法与 GJSON 路径语法详见 MCP 服务器实现指南。6.2 配置文件的自动生成脚本该服务的三个文件api.json、mcp-server.yaml、README_ZH.md/README.md由脚本 create_api_directories.sh 批量生成在脚本的api_codes与server_names数组中维护了 35 个云市场 API 的映射企业专利查询对应cmapi00049059/business-patent-query通过openapi-to-mcp工具将api.jsonOpenAPI 3.0.1 规范转换为mcp-server.yaml使用yunmarket-tmpl.yaml模板再通过yaml_to_markdown.py与translate_readme.py生成中英文 README。因此api.json与mcp-server.yaml在参数、端点、响应结构上严格一致是理解该服务最权威的两份证据。6.3 构建与镜像发布如需将该 MCP Server 打包发布可复用 mcp-servers/Makefile 中定义的目标# 构建 WASM 二进制GOOSwasip1 GOARCHwasm go build -buildmodec-shared make SERVER_NAMEbusiness-patent-query build # 构建包含 WASM 二进制的 Docker 镜像 make SERVER_NAMEbusiness-patent-query REGISTRYmy-registry.example.com/ build-image镜像基于scratch构建仅包含/plugin.wasm一个产物见 Dockerfile。七、典型应用场景与注意事项典型场景知识产权风险排查在立项或产品发布前用公司名或技术关键词检索专利列表确认是否存在侵权风险竞争对手分析输入竞对公司名称或统一社会信用代码拉取全量专利清单评估其技术布局方向研发方向调研检索特定技术领域IPC 分类的专利了解已有技术方案为研发调整提供参考AI 助手集成将两个工具暴露给 AI Agent用户用自然语言即可完成查某公司专利到看某专利详情的完整链路。注意事项pageSize最大不超过 10 条大批量检索需配合pageIndex分页遍历可通过Paging.TotalRecords计算总页数dtype仅支持json与xml两种格式默认jsonAppCode 是访问所有已订阅云市场 API 的统一凭证注意保管避免泄露导致额度被盗用免费试用额度用完后需重新订阅可用额度可在云市场用户控制台实时查看部署时若使用 all-in-one 插件多个 MCP Server 共享同一插件实例通过server.name区分可降低网关上部署多个插件的额外开销。八、小结本文以business-patent-query企业专利查询服务为实例完整走通了云市场订阅 API → 获取 AppCode → 编写 REST-to-MCP 配置 → 理解工具参数与响应结构的全流程。通过 Higress 的 MCP 能力云市场数千个 REST API 都能以同样的方式低成本接入 AI 应用统一获得网关层面的认证、鉴权、限流与观测能力。读者可在此基础上参考 api.json 与 mcp-server.yaml 复制出属于自己业务场景的 MCP 服务配置。【免费下载链接】higress AI Gateway | AI Native API Gateway项目地址: https://gitcode.com/GitHub_Trending/hi/higress创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考