MCP Protocol · Open Source

PatentHub MCP

让 AI 助手直接为你检索专利、商标、企业数据。
无需打开网站，直接用自然语言提问，AI 调用工具返回结果。

快速开始 查看所有工具 →
✓ 21 个工具 ✓ 7+ AI 客户端 ✓ 全静态页面 ✓ 免部署接入
1

什么是 PatentHub MCP

Model Context Protocol（MCP）是一种让 AI 助手调用外部工具的开放协议。PatentHub MCP 是其官方实现。

PatentHub MCP 是一个基于 MCP 协议的服务端插件，安装后你的 AI 助手（如 Cursor、Claude Desktop）就能直接调用 PatentHub 的专利数据库，无需手动搜索网页。AI 可以根据你的问题自动选择合适的工具，理解参数含义，并返回结构化的专利或商标信息。

🔍

专利检索

支持关键词、申请人、发明人、分类号等多维度检索，返回完整专利列表和摘要。

®️

商标识别

从文本中自动识别商标词，支持图形商标相似检索和文字商标精确查询。

🏢

企业画像

分析企业的专利布局、申请趋势、竞争对手、技术分类分布等关键信息。

🌍

国际检索

检索全球外观专利和国际商标，支持图形和文字双模式，覆盖 100+ 国家。

2

快速开始

3 步完成接入，全程约 5 分钟。

1

获取 API Token

访问 PatentHub 官网申请 API Token，这是调用所有接口的凭证。

前往申请 Token →
2

配置你的 AI 客户端

在下方「AI 客户端配置」章节找到你使用的客户端，按步骤填入服务地址和 Token。

查看配置指南 →
3

开始使用

直接用自然语言向 AI 提问，AI 会自动调用合适的工具并返回结果。例如：

对话 
帮我搜索华为的石墨烯电池相关专利

查看 CN108251808A 的权利要求全文

分析宁德时代的专利申请趋势
🔍
共 21 个工具
未找到匹配的工具，请尝试其他关键词。
专利详情（10 个工具）
patent_base
获取单个专利基本信息，ID 必须从搜索接口获取，否则返回 215 错误。注意：每天只允许 200 次直接访问。
必填：t, id（专利ID）
提示：ID 有效期 60 分钟
patent_base(t=token, id="CN108251808A")
patent_detail
获取专利完整信息，包括基本信息、权利要求、说明书，同步返回多个维度的数据。
必填：t, id
patent_detail(t=token, id="CN108251808A")
patent_claims
获取专利权利要求全文，包括独立权利要求和从属权利要求。
必填：t, id
patent_claims(t=token, id="CN108251808A")
patent_description
获取专利说明书全文，包括技术领域、背景技术、发明内容等章节。
必填：t, id
patent_description(t=token, id="CN108251808A")
patent_legal
获取专利法律事务列表，包括著录项目变更、转让、质押、许可等法律状态信息。
必填：t, id
patent_legal(t=token, id="CN108251808A")
patent_citing
获取专利引用数据，包括专利引用、非专利引用和被引用情况。
必填：t, id
patent_citing(t=token, id="CN108251808A")
patent_similar
获取与目标专利相似的专利列表，用于技术相似性分析或侵权排查。
必填：t, id
patent_similar(t=token, id="CN108251808A")
patent_family
查询专利同族信息。fId 为简单同族 ID，efId 为扩展同族 ID，两者二选一。
必填：t
可选：fId（简单同族）, efId（扩展同族）
patent_family(t=token, fId="xxx")
patent_drawings
获取专利说明书附图列表，返回图片的 key，用于后续调用 patent_drawing_image 获取图片。
必填：t, id
patent_drawings(t=token, id="CN108251808A")
patent_drawing_image
获取说明书附图（返回 Base64 编码的图片数据）。key 必须从 patent_drawings 返回的附图 key 列表中获取。
必填：t, key（附图 key）
⚠️：key 需先调用 patent_drawings 获取
patent_drawing_image(t=token, key="xxx")
图片 / PDF（3 个工具）
patent_image
获取专利摘要附图（返回 Base64 编码的图片数据）。key 从 patent_search 返回的 imagePath 字段获取。
必填：t, key（图片 key）
来源：patent_search 返回的 imagePath
patent_image(t=token, key="xxx")
patent_pdf
获取专利 PDF 全文（返回 Base64 编码的数据）。key 从 patent_search 返回的 pdfList 获取。
必填：t, key（PDF key）
来源：patent_search 返回的 pdfList
patent_pdf(t=token, key="xxx")
patent_drawing_image
获取说明书附图（返回 Base64 编码的图片数据）。key 必须从 patent_drawings 返回的附图 key 列表获取。
必填：t, key
patent_drawing_image(t=token, key="xxx")
商标（5 个工具）
trademark_detect
从文本中自动识别并提取商标词，支持大小写敏感开关。例如：从"Apple iPhone 手机壳"中识别出"Apple"和"iPhone"。
必填：t, text（待检测文本）
可选：caseSensitive（是否大小写敏感）
trademark_detect(t=token, text="Apple iPhone手机壳")
world_design_search
国际外观专利检索，可传图片（以图搜图）或关键词检索，支持洛迦诺分类号筛选。
必填：t
可选：image（图片文件）, imageBase64（图片Base64）, keyword, size, tProtection, locarnoClass
world_design_search(t=token, keyword="手机", size=20)
world_trademark_text_search
按文字条件检索国际商标，支持商标局、尼斯分类号等筛选条件。
必填：t, keyword
可选：size, tmOffice（商标局）, niceClass（尼斯分类号）
world_trademark_text_search(t=token, keyword="APPLE", tmOffice="US", niceClass="9")
world_trademark_text_batch_search
按多个关键词批量检索国际商标，最多支持 10 个关键词同时查询，适用于品牌监测。
必填：t, keywords（逗号分隔，最多 10 个）
可选：size, tmOffice, niceClass
world_trademark_text_batch_search(t=token, keywords="APPLE,GOOGLE,MICROSOFT", size=10)
world_trademark_graphic_search
国际商标图样相似检索，以图搜图方式查找相似商标，支持商标局和尼斯分类号过滤。
必填：t
可选：image, imageBase64, keyword, size, tmOffice, niceClass
world_trademark_graphic_search(t=token, imageBase64="...", size=20)
企业（1 个工具）
enterprise_portrait
获取企业统计数据，包括法律状态分布、申请趋势、技术布局、竞争对手分析等多维度画像。
必填：t, en（企业名称）
enterprise_portrait(t=token, en="华为技术有限公司")
统计 / 配额（1 个工具）
api_usage
查询接口使用情况和剩余配额，支持按日期查看每日用量，帮助你监控 API 消耗。
必填：t, apiUrl（接口路径，如 /s）
可选：day（日期，格式 YYYY-MM-DD）
api_usage(t=token, apiUrl="/s", day="2026-08-31")
3

AI 客户端配置

在下方找到你使用的 AI 客户端，按步骤完成配置。

Cursor IDE

AI 代码编辑器 · Windows / macOS / Linux
  1. 打开 Cursor，点击左下角 设置（齿轮图标）
  2. 在左侧菜单中选择 MCP
  3. 点击 Add New MCP Server
  4. 在编辑器中粘贴下方 JSON 配置（替换 your_api_token_here 为你的 Token）
  5. 保存后 AI 会自动加载工具，首次加载可能需要 10~30 秒
JSON · Cursor MCP 配置 
{
  "mcpServers": {
    "patenthub": {
      "url": "https://www.patenthub.cn/mcp",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer your_api_token_here"
      }
    }
  }
}
配置成功后，对 AI 说「你支持哪些工具？」，如果返回 patent_search、patent_base 等工具名，说明配置正确。

Claude Desktop

Anthropic 官方桌面应用 · Windows / macOS / Linux
  1. 确认 Claude Desktop 已安装并关闭
  2. 找到配置文件路径：
    macOS/Linux：~/.config/claude-desktop/mcp.json
    Windows：%APPDATA%\Claude\mcp.json
  3. 用文本编辑器打开（或新建）该文件，粘贴下方 JSON 配置
  4. 保存文件，重启 Claude Desktop
JSON · Claude Desktop MCP 配置 
{
  "mcpServers": {
    "patenthub": {
      "url": "https://www.patenthub.cn/mcp",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer your_api_token_here"
      }
    }
  }
}
启动 Claude Desktop 后，对话框左下角显示「工具」图标（工具箱图标），点击展开能看到 patent_search 等工具，说明配置成功。

Claude Code

命令行工具 · 需要先配置 Claude Desktop
  1. Claude Code 复用 Claude Desktop 的 MCP 配置，无需单独配置
  2. 先按上方「Claude Desktop」步骤完成配置
  3. 在终端执行 claude 即可启动
  4. 确认方式：在 Claude Code 中输入「/tools」查看可用工具列表
Claude Code 启动后，输入 /tools，如果看到 patent_search 等工具名，说明 MCP 已加载。

WorKBuddy

AI 工作助手 · Web / 桌面端
  1. 打开 WorKBuddy，进入 设置 → MCP
  2. 点击「添加服务器」，名称填写 patenthub
  3. 填入服务地址：https://www.patenthub.cn/mcp
  4. 在 Headers 中添加一项：Authorization，值为 Bearer your_api_token_here
  5. 保存并等待连接成功提示
JSON · WorKBuddy MCP 配置 
{
  "mcpServers": {
    "patenthub": {
      "url": "https://www.patenthub.cn/mcp",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer your_api_token_here"
      }
    }
  }
}
保存后询问 AI「列出你支持的工具」，看到 patent_search、patent_base 等即为成功。

OpenCode

开源 AI 编程助手 · Linux / macOS
  1. 打开 OpenCode，进入 Settings → MCP
  2. 点击「Add Server」，名称填写 patenthub
  3. Server URL 填入：https://www.patenthub.cn/mcp
  4. 添加 Header：Authorization: Bearer your_api_token_here
  5. 保存并刷新连接
配置完成后，在对话框中输入「你有哪些工具可用？」，确认 patent_search 在列表中。

VS Code + Cline 扩展

Cline MCP 扩展 · Windows / macOS / Linux
  1. 在 VS Code 中安装 Cline 扩展（搜索"Cline"并安装）
  2. 打开 VS Code 设置，搜索 Cline:MCP Servers
  3. 点击「在 settings.json 中编辑」，在 mcpServers 节点下添加 patenthub 配置
  4. 也可以直接在项目根目录或用户目录的 .vscode/mcp.json 文件中配置
JSON · VS Code MCP 配置（.vscode/mcp.json） 
{
  "mcpServers": {
    "patenthub": {
      "url": "https://www.patenthub.cn/mcp",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer your_api_token_here"
      }
    }
  }
}
重新加载 Cline 扩展后，询问 AI「你支持哪些 MCP 工具？」，看到 patent_search 等工具名即成功。

其他 MCP 客户端

通用配置模板，适用于所有支持 MCP 协议的客户端

以下是通用配置模板，适用于任何实现了 MCP 协议的 AI 客户端（如 Windsurf、Roo Code、 Continue.dev 等）。关键配置项为：

  • url：MCP 服务地址，格式为 https://你的服务器域名/mcp
  • transport：传输协议，固定填写 streamable-http
  • headers.Authorization：Bearer Token 认证，填入你的 API Token
JSON · 通用 MCP 配置模板 
{
  "mcpServers": {
    "patenthub": {
      "url": "https://www.patenthub.cn/mcp",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer your_api_token_here"
      }
    }
  }
}
保存配置后重新启动客户端，询问 AI「你支持哪些工具？」，确认 patent_search、patent_base 等工具存在。
4

工具调用流程

了解工具之间的依赖关系，正确传入参数。

┌─────────────────────────┐
│    patent_search         │  ← 第一步：搜索专利，获取 ID（有效期 60 分钟）
│    (关键词检索)            │
└──────┬────────────────────┘
       │
       ▼
┌──────┴────────────────────┐
│  返回 patent ID           │
│  imagePath / pdfList       │
└────┬──┬──┬──┬──┬──┬──┬──┬──┘
     │  │  │  │  │  │  │  │  │
     ▼  ▼  ▼  ▼  ▼  ▼  ▼  ▼
┌─────┐ ┌────────┐ ┌──────────┐ ┌──────────┐
│base │ │claims  │ │desc      │ │drawings  │  ...
│detail│ │legal   │ │citing    │ │similar   │
│family│ │legal_st│ │pdfList   │ │imagePath │
└─────┘ └────────┘ └──────────┘ └──────────┘
                              │
                              ▼
                       ┌──────────────┐
                       │patent_drawings│ 附图列表（返回附图 key）
                       └──────┬───────┘
                              │ 附图 key
                              ▼
                       ┌──────────────┐
                       │patent_image  │ 摘要附图（key=imagePath）
                       │patent_pdf    │ PDF全文（key=pdfList 中的项）
                       │patent_drawing│ 说明书附图（key=附图key）
                       │_image        │
                       └──────────────┘

┌─────────────────────────────────────────────────────┐
│  重要约束：                                         │
│  1. patent_base 等详情接口，ID 必须来自 search 返回  │
│  2. patent_image 用 patent_search 返回的 imagePath  │
│  3. patent_drawing_image 用 patent_drawings 返回的 │
│     附图 key                                        │
│  4. patent_pdf 用 patent_search 返回的 pdfList 中的 │
│     key                                             │
└─────────────────────────────────────────────────────┘
5

错误码速查

接口返回的 code 字段含义及处理方式。

Code 含义 处理方式
200 成功 正常返回数据，无需处理。
201 Token 为空 检查 t 参数是否传入，或检查 HTTP Header 中的 Authorization。
202 非法 Token 核对 Token 是否正确，可前往 官网 重新获取。
203 响应异常 服务器端临时问题，稍后重试。
204 IP 被拒绝 检查是否配置了 IP 白名单，或当前 IP 是否在允许范围内。
205 参数为空 检查必填参数（如 q、id）是否已传入。
206 无数据 当前检索条件没有匹配结果，尝试修改检索词或筛选条件。
207 当日次数用尽 等待次日重置，或升级 API 套餐获取更多配额。
208 无权限访问该接口 你的 API Token 未开通此接口权限，请联系 PatentHub 开通。
209 版本号为空 请求中缺少 v=1 参数，请确保所有接口调用都包含版本参数。
210 参数格式错误 检查参数格式是否符合接口说明，如日期格式、ID 格式等。
211 额度用尽 年度额度已耗尽，需等待年度重置或升级套餐。
215 异常访问（ID 不合法） 传入的专利 ID 不是来自 search 接口返回，需重新从搜索获取 ID。
6

常见问题

点击问题查看答案。

检查以下几点：① MCP 服务地址是否正确（确保是 https://www.patenthub.cn/mcp）；② Token 是否在 headers 中正确传入（格式：Bearer your_token）；③ AI 客户端是否已重启（配置保存后需完全退出再重新打开）；④ 网络是否能访问 PatentHub 服务器。可在浏览器中直接打开服务地址测试是否可访问。
错误码 208 表示你的 API Token 没有开通该接口的使用权限。需要前往 PatentHub API 申请页面，在「我的接口」中开通对应接口权限。每个 Token 的权限是独立配置的，开通后才能正常使用。
错误码 215 表示你传入的专利 ID 不是来自 search 接口返回，接口有防滥用保护。正确流程是：① 先调用 patent_search 搜索专利；② 从返回结果中提取 id 字段；③ 用这个 id 调用 patent_base。直接手动输入 ID（如 CN108251808A）会导致此错误。
在 AI 对话中直接询问「你支持哪些工具？」或「列出你的 MCP 工具」，如果返回结果中包含 patent_search、patent_base、patent_claims 等工具名，说明 MCP 已正确加载。你也可以询问 AI「你认识 patent_search 吗？」来做简单验证。
访问 PatentHub API 申请页面 注册账号并申请 Token。Token 的获取方式和费用策略由 PatentHub 官方制定，具体请参考官网定价页面。基础调用一般有每日免费额度，超出后需付费升级。
不同接口有不同的配额限制，详见接口文档。使用 api_usage 工具可以实时查询各接口的当日使用量和剩余配额。常见的配额限制包括：patent_base 每天最多 200 次直接访问（不经过搜索）；其他接口通常按日额度或月额度计算。额度耗尽后需等待重置或升级套餐。
使用 world_design_search（外观专利）和 world_trademark_graphic_search（商标图样）两个工具。将图片转为 Base64 编码后传入 imageBase64 参数，或直接传图片文件给 image 参数。AI 会自动处理图片格式并将结果返回。注意：图片不宜过大，建议压缩至 1MB 以下以提高传输效率。
从 patent_search 返回的专利 ID 有效期为 60 分钟。超过 60 分钟后，该 ID 将无法用于调用 patent_base 等详情接口（会返回 215 错误）。建议在搜索后立即查看详情，或重新搜索刷新 ID。
7

技术支持

遇到问题或需要帮助时，可通过以下方式联系我们。

🌐

官网

www.patenthub.cn
📖

API 文档

接口说明文档
💬

MCP 源码

GitHub 项目地址
© 2026 PatentHub · AI Patent & Trademark Assistant · Built with MCP Protocol

快速链接

核心工具

  • patent_search（专利搜索）
  • patent_base（专利详情）
  • world_design_search（外观检索）
  • world_trademark_graphic_search（商标检索）
  • enterprise_portrait（企业画像）

配置客户端

  • Cursor IDE
  • Claude Desktop / Code
  • WorKBuddy
  • OpenCode
  • VS Code (Cline)
PatentHub MCP Guide · 全静态页面，无外部依赖 · 2026