Higress 企业专利查询 MCP Server：从 AppCode 申请到专利列表与详情查询的完整实践

Higress 企业专利查询 MCP Server从 AppCode 申请到专利列表与详情查询的完整实践【免费下载链接】higress AI Gateway | AI Native API Gateway项目地址: https://gitcode.com/GitHub_Trending/hi/higress导读本文围绕 Higress 仓库中business-patent-query这个云市场 API MCP 服务展开讲解如何基于阿里云云市场企业专利信息API在 Higress 上快速搭建一个面向 AI Agent 的专利检索工具。读完本文你将掌握如何申请云市场 AppCode 并完成 Higress MCP Server 配置、两个核心工具专利信息列表、专利信息详情的参数语义与调用方式、底层 REST-to-MCP 模板配置机制以及仓库中该服务的完整实现结构。一、服务定位与核心价值business-patent-query是 plugins/wasm-go/mcp-servers 目录下由 Higress 托管的云市场 API MCP 服务之一专注于为企业或个人用户提供专利相关信息查询能力。它的核心价值在于借助该服务用户可以通过关键词如公司名称、社会统一信用代码、注册号快速检索某一技术领域内的全部相关专利从而规避知识产权侵权风险在研发立项或产品上市前检索目标技术领域的既有专利避免踩入他人专利布局指引自身研发方向通过分析竞品或行业专利分布找到技术空白点为研发决策提供依据支撑市场调研与竞争分析批量掌握某行业或某公司的专利全景用于竞对监测和技术趋势研判。从整体架构看该服务属于 Higress MCP Server 生态的一员Higress 作为基于 Envoy 的 API 网关通过插件机制统一托管 MCP Server为 AI Agent 的工具调用提供认证鉴权、限流、审计日志与可观测性能力参见 MCP 服务器实现指南 的背景一节。business-patent-query正是云市场 REST API Higress REST-to-MCP 能力的典型落地样例。二、前置准备云市场订阅与 AppCode 申请在配置服务之前需要先完成阿里云云市场侧的准备工作。关联文档README_ZH.md给出了三步流程订阅 API进入企业专利信息API 详情页订阅该 API。若希望低成本验证可优先使用免费试用额度。获取 AppCode使用阿里云账号登录云市场用户控制台查看已订阅 API 服务的 AppCode并将其配置到 Higress MCP Server 的配置中。需要注意在阿里云市场订阅 API 服务后获得的 AppCode 对所有已订阅 API 服务是同一个只需使用这一个 AppCode 即可访问所有已订阅的 API 服务。额度管理云市场用户控制台会实时展示已订阅预付费 API 服务的可用额度当免费试用额度用完后可以选择重新订阅以继续使用。三、配置 MCP Server一份 YAML 搞定两个工具business-patent-query服务的完整配置存放在 mcp-server.yaml它不需要编写任何 Go 代码而是利用 Higress 内置的REST-to-MCP能力把云市场 REST API 直接转换为 MCP 工具。配置结构分为server服务器身份与全局配置和tools工具定义两大部分server: name: business-patent-query config: appCode: tools: - name: business-patent-query description: 查询企业或某技术的专利帮助用户掌握相同技术领域的发展状况为规避他人知识产权和调整研发方向提供参考 args: - name: dtype description: 返回数据格式json或xml默认json type: string position: query - name: keyword description: 搜索关键字公司名称、社会统一信用代码、注册号 type: string required: true position: query - name: pageIndex description: 页码默认第1页 type: integer position: query - name: pageSize description: 每页条数默认为10最大不超过10条 type: integer position: query 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}} responseTemplate: prependBody: | # API Response Information ...关键配置要素说明server.nameMCP Server 的名称用于在 Higress 插件中标识并路由到对应的 MCP 服务当多个 MCP Server 打包进 all-in-one 插件时系统正是通过该 name 字段找到对应的 server参见 MCP 服务器实现指南 的All-in-One 集成一节。server.config.appCode上一步从云市场控制台获取的 AppCode需填入该字段生产环境建议通过 Higress 的配置管理能力注入避免明文硬编码。模板中的{{.config.appCode}}即引用此配置项。requestTemplate描述如何构造对上游 REST API 的 HTTP 请求包括 URL、GET 方法和两个请求头——Authorization: APPCODE {{.config.appCode}}用于网关侧鉴权X-Ca-Nonce: {{uuidv4}}每次生成唯一 UUID 防止重放。responseTemplateprependBody用于在返回给 AI 的响应正文前附加响应结构说明把原始 JSON 响应字段翻译成 AI 可理解的中文语义降低 Agent 解析成本。模板语法原理REST-to-MCP 机制上述{{.config.appCode}}、{{uuidv4}}等语法来源于 Higress REST-to-MCP 功能所基于的 GJSON Template 库——它将 Go 模板语法与 GJSON 路径语法结合请求模板用.config.fieldName访问服务器配置值用.args.argName访问工具参数用于构造 URL、请求头与请求体响应模板用 GJSON 路径语法访问 JSON 响应字段配合if、range等控制结构与add、upper、lower等 Sprig 函数超过 70 个能力上与 Helm 模板等价将响应转换为适合 AI 消费的格式UUID 生成uuidv4是内置函数之一用于生成每次请求唯一的防重放标识。REST-to-MCP 能力内置于所有 MCP Server无需写一行业务代码即可把任意 REST API 接入 AI Agent——这正是business-patent-query能以极低门槛提供服务的底层机制。四、工具一专利信息列表business-patent-query用途与场景该工具允许用户根据关键字如公司名称、社会统一信用代码、注册号查找相关专利列表。适用场景包括需要全面了解某行业或某公司的专利布局、市场调研、竞争对手分析等。参数说明参数类型必填默认值说明dtypestring否json返回数据格式支持 json 或 xml默认 jsonkeywordstring是—搜索关键字公司名称、社会统一信用代码、注册号pageIndexinteger否1指定返回结果的页码默认第一页pageSizeinteger否10每页显示的结果数量默认为 10 条最大不超过 10 条底层请求对应上游接口为GET http://icpatent.market.alicloudapi.com/utn/ip/PatentPageByKey/V2从 api.json 的 OpenAPI 定义可以确认keyword是唯一必填参数其余参数pageIndex、pageSize、dtype均为可选。响应结构响应包含专利列表分页信息及通用元数据字段语义如下摘自 mcp-server.yaml 的响应结构说明data.Items[]专利列表数组每个元素包含Agency代理机构ApplicationDate申请日期ApplicationNumber申请号AssigneeStringList申请人InventorStringList发明人IPCListIPC 分类号IPCDescIPC 分类描述KindCodeDesc类别代码描述如发明LegalStatusDesc法律状态描述如授权PublicationDate公开日期PublicationNumber公开号Title专利标题Id专利 IDinteger该 ID 是下一个工具专利信息详情的入参来源data.Paging分页信息包含PageIndex当前页码、PageSize每页显示条数、TotalRecords总记录数orderNo订单号statusCode状态码成功时为 1statusMessage状态消息如请求成功orderNo、statusCode、statusMessage这组元数据用于跟踪请求状态与解析数据是云市场 API 的统一约定。五、工具二专利信息详情patent-detail用途与场景基于已知的专利 ID该工具获取单个专利的具体细节信息适用于深入研究某一项具体专利内容或需要详细了解某项技术解决方案的情况。参数说明参数类型必填默认值说明dtypestring否json响应数据格式默认 jsonidinteger是—专利唯一标识符通常从专利信息列表接口返回的Id字段获得底层请求对应上游接口为GET http://icpatent.market.alicloudapi.com/utn/ip/PatentDetail从 api.json 可见id为必填 query 参数dtype可选。工具调用链路为先用专利信息列表拿到Id再将该Id传给专利信息详情。响应结构详情接口返回比列表接口丰富得多的单条专利完整信息基本信息Title标题、Abstract摘要、KindCodeDesc类型代码描述如发明、ApplicationNumber申请号、PublicationNumber公布号、ApplicationDate申请日期、PublicationDate公布日期主体信息AssigneestringList专利权人列表、InventorStringList发明人列表、Agency代理机构、Agent代理人审查信息PrimaryExaminer主审查员、AssiantExaminer辅助审查员注意字段拼写与上游保持一致分类信息IPCList国际专利分类号列表、IPCDesc国际专利分类号描述法律状态LegalStatusDesc法律状态描述、LegalStatusDate法律状态日期、PatentLegalHistory[]法律状态变更历史数组包含LegalStatus、LegalStatusDate、Desc三个子字段引用与扩展Cites引用、OtherReferences其他引用、DocumentTypes文档类型、PatentImage专利图片链接通用元数据orderNo订单编号、statusCode状态码、statusMessage状态消息以 api.json 中提供的真实示例数据为例一次详情查询的返回大致形如标题为一种基于非对称密码算法的保护隐私征信方法、申请号CN201510241189.8、公布号CN104821883B、法律状态授权、专利权人为上海凭安企业信用征信有限公司,上海凭安征信服务有限公司等这些字段组合起来足以支撑 AI Agent 对单件专利的完整解读。六、如何在 Higress 上启用该 MCP Serverbusiness-patent-query无需单独编写 Go 工具代码——它由 mcp-server.yaml 声明式定义而 api.json 则是生成该配置的 OpenAPI 源文件。目录结构与生成方式该服务的目录结构非常精简plugins/wasm-go/mcp-servers/mcp-business-patent-query/ ├── README.md # 英文文档 ├── README_ZH.md # 中文文档关联文档主体 ├── api.json # 云市场 API 的 OpenAPI 描述含全部参数与响应 schema └── mcp-server.yaml # REST-to-MCP 服务配置两个工具的定义从 mcp-scripts/create_api_directories.sh 可以看到这类云市场 MCP 服务的标准生成流水线以api.json为输入通过openapi-to-mcp工具生成mcp-server.yaml再经脚本自动产出 README 文档。这意味着云市场 API 接入 Higress 的过程已经高度工具化、可复制。部署与使用步骤在mcp-server.yaml的server.config.appCode字段填入从云市场控制台获取的 AppCode将配置作为 Higress 的 MCP Server 插件配置下发配置方式与其他 MCP Server 插件一致通过server.name字段识别服务参见 MCP 服务器实现指南 的插件配置一节MCP Server 插件要求 Higress 2.1.0 及以上版本在 AI Agent / MCP 客户端中连接 Higress 暴露的 MCP 端点即可通过business-patent-query与patent-detail两个工具完成专利检索。如需以独立 WASM 形式构建与部署自定义 MCP Server可参考 mcp-servers/Makefile 中的目标make build、make build-image、make build-push以及 Dockerfile基于 scratch 镜像、仅包含 WASM 二进制的极简镜像典型构建命令为GOOSwasip1 GOARCHwasm go build -buildmodec-shared -o main.wasm main.go。七、总结与延伸阅读business-patent-query完整展示了云市场 REST API → Higress REST-to-MCP 配置 → AI Agent 可调用的 MCP 工具这一低成本接入范式无需编写业务代码仅凭一份 YAML 即可将专利列表检索与专利详情查询两个能力开放给 AI 生态。它既是一个可直接落地的专利情报工具也是理解 Higress MCP 服务体系与模板机制的最佳入门样例。如需进一步深入建议阅读MCP 服务器实现指南中文系统讲解 MCP Server 插件开发、REST-to-MCP 模板语法、all-in-one 集成与构建部署mcp-server.yaml 与 api.json本服务完整的配置与接口契约mcp-scripts/create_api_directories.sh云市场 API 转 MCP 服务的自动化生成流水线便于理解同目录下数十个同类 MCP Server 的来历。【免费下载链接】higress AI Gateway | AI Native API Gateway项目地址: https://gitcode.com/GitHub_Trending/hi/higress创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考