MCP 全部功能一览

专利实务里最费时间的往往不是撰写本身，而是查资料：申请人的工商信息在一个地方查，著录项目在另一个系统核，说明书全文还得单独下载存档。这套 MCP 服务把这些重复查询封装成标准工具，交给 AI 去调用。

本文是这套服务的完整功能说明：每个工具能查什么、参数怎么传、返回长什么样、有哪些边界，以及接入与鉴权的全部细节。文中所有返回示例均取自真实调用。

1一眼看全：能力地图

7 个工具按数据域分成三类。企业类回答「这家公司是什么情况」，费用类回答「还要交多少钱、能不能减」，专利类回答「这件专利是什么、全文在哪」。

2接入方式与协议

服务以标准 MCP（Model Context Protocol）对外提供，任何支持 MCP 的 AI 客户端都能接入。

最简调用示例

# 1) 握手
POST https://www.patentg.com/mcp
Content-Type: application/json
X-MCP-Orkey: 你的orkey

{"jsonrpc":"2.0","id":1,"method":"initialize",
 "params":{"protocolVersion":"2025-06-18"}}

# 2) 调用工具（查一件专利的著录信息）
{"jsonrpc":"2.0","id":2,"method":"tools/call",
 "params":{"name":"get_patent_info",
           "arguments":{"patent_no":"CN121087679B"}}}

3鉴权：orkey 准入机制

所有工具调用都要求携带有效凭证，未携带或无效时会被直接拒绝，不会返回任何业务数据。

凭证怎么传

两条准入通路

被拒绝时返回什么

{"jsonrpc":"2.0","id":2,
 "result":{"isError":true,
           "content":[{"type":"text",
                       "text":"拒绝调用：调用凭证无效或未授权。该 MCP 服务需要有效的 orkey 才能调用……"}]}}

4工具详解

以下逐个说明。每个工具给出：用途、入参表、返回字段、真实返回示例、注意事项。

腾讯科技（深圳）有限公司
● 9144030071526726XG
● 法人：马化腾  ● 2000-02-24
● 深圳市南山区高新区科技中一路腾讯大厦 35 层

单位：腾讯科技（深圳）有限公司
统一社会信用代码：9144030071526726XG
数据来源：CNIPA 实时
费减备案记录：0 条
结论：未查询到费减备案记录

年度备案明细（按年度倒序）：
  （无）

否。腾讯科技（深圳）有限公司（9144030071526726XG）未查询到费减备案记录。数据来源：CNIPA 实时

【2025116396651】2 项应缴费：
  - 发明专利第2年年费 ｜ 金额 135.00 ｜ 期限 2026-12-11
  - 发明专利第3年年费 ｜ 金额 180.00 ｜ 期限 2027-12-13

以下专利号不合法，已跳过：
  - BADNUMBER：不是有效的 13 位中国专利申请号

发明名称：一种抗寒保暖的复合羊毛面料及其制作工艺
申请号：CN202511639665.1
公开（公告）号：CN121087679B
申请日：2025.11.11　公开（公告）日：2026.02.03
申请人：上海悠途实业有限公司　发明人：张凯;章晋增
主分类号：D04B1/10(2006.01)

摘要：本发明公开了……

说明书 PDF 已就绪：
  文件名：CN121087679B.pdf
  下载地址：https://www.patentg.com/mcp/file/CN121087679B.pdf?t=eyJmIjoiQ04xMjEwODc2NzlCLnBkZiIsImsiOiI4MWM2ZGVjZi…
（链接 10 分钟内有效，可直接在浏览器打开或另存为；过期后重新调用本工具即可获取新链接）

5说明书 PDF 下载的完整链路

下载是整套服务里唯一涉及「文件交付」的能力，因此单独设计成两段式：先签发令牌，再凭令牌取件。理解这条链路，能解释你遇到的绝大多数下载问题。

为什么不直接给一个静态地址

说明书 PDF 的文件名由公开号推导（如 CN121087679B.pdf），如果暴露出一个公开静态目录，任何人只要按公开号拼地址就能批量拉取全文。所以取件地址改为带签名的临时链接：不可枚举、有时效、与文件名绑定。

两段式流程

也可以给前端/后台单独签发

如果需要在你的系统里生成「用户可直接点开」的链接，可调用签发接口换取令牌（同样必须带有效 orkey）：

POST https://www.patentg.com/mcp/mcpdlissue
Content-Type: application/x-www-form-urlencoded
X-MCP-Orkey: 你的orkey

filename=CN121087679B.pdf

→ 返回
{"code":0,"data":{"filename":"CN121087679B.pdf",
                "url":"https://www.patentg.com/mcp/file/CN121087679B.pdf?t=…",
                "expires_in":600}}

取件端的安全约束

失败时返回什么

6错误处理与边界

协议层错误（标准 JSON-RPC 错误码）

工具层错误（isError: true + 可读文案）

参数缺失、号码不合法、上游接口异常等，统一以 isError: true 返回，并在 content[0].text 给出可直接转达给用户的中文说明，例如「错误：keyword 不能为空」「专利号错误：xxx」。

主体解析：多候选怎么办

用简称查费减时可能命中多家企业。此时服务端不会随便挑一家，而是返回候选清单，提示用 pick_index 指定序号，或直接补传统一社会信用代码。如果该主体不在企业库内（如事业单位），会提示补充完整名称 + 信用代码。

7数据来源与性能

每次返回都会标注数据来源，便于判断结果的时效性。

各工具的耗时特征

8安装配置

在 AI 客户端的 MCP 配置文件里加一段即可。以 WorkBuddy 为例：点击「连接器 → 自定义连接器 → 配置 MCP」，或直接编辑配置文件。

配置文件位置：~/.workbuddy/mcp.json（Windows 通常为 C:\Users\你的用户名\.workbuddy\mcp.json）

{
  "mcpServers": {
    "patentg-web-mcp": {
      "type": "http",
      "url": "https://www.patentg.com/mcp",
      "headers": {
        "X-MCP-Orkey": "你的orkey"
      }
    }
  }
}

其他常见客户端：

保存后完全退出并重启客户端，再到连接器（或 MCP）管理页面，对这个新服务点一次「信任」即可生效。之后每次对话，AI 都会自动判断何时该调用它。

9使用边界与合规说明

10常见问题

下载链接打开是 403，是不是坏了？

大概率是过期。链接有效期 10 分钟，重新调用一次 download_patent_pdf 就能拿到新链接，不需要做别的。

为什么第一次查著录信息要等 5 秒？

服务端需要向官方接口实时取数并缓存。同一件专利再查就很快，这是正常的冷启动现象，不是卡住。

查费减返回「未查询到费减备案记录」，是出错了吗？

不是。这是正常结论——表示该主体在当前年度没有备案记录。如果确认该单位已备案，请检查名称与统一社会信用代码是否与备案时填写的一致。

为什么企业名称要写完整？

「XX科技」这类简称会匹配到一串同名企业，需要二次确认。写全称（含「有限公司」等后缀）或直接给统一社会信用代码，可以一次命中。

查询应缴费用时为什么单件也要写成数组？

因为该接口本身支持批量，入参统一为数组形式。单件写成 ["2025116396651"] 即可，这样同一套调用方式既能查一件也能查几十件。

可以同时查多少件？

应缴费用查询一次最多 50 件（上游接口单页上限）。超过会被明确拒绝，请分批调用——服务端不会静默截断，因为漏查的号码会被误报成「未查询到」。