Patent Mcp Server

Patent MCP 服务

🚀 中国专利最准确的开源 MCP。 让你的 AI Agent 能够准确读取中国专利，并覆盖全球专利。

一个为 AI Agent 提供专利数据访问能力的 MCP（Model Context Protocol）服务——支持经过 CPC 感知纠正的中国专利，以及美国和全球专利（WO）。在你的本地计算机上运行。无需外部 API，无需订阅。始终采用 MIT 许可证。

---

为什么选择自托管

• 它只是一个 Python 程序。 安装后，Agent 就能使用。无需维护服务，也无需共享凭据。
• 80% 的使用场景无需 API 密钥。 专利详情和权利要求直接来自 Google Patents 的公开页面。
• 你的数据留在本地。 除了浏览器会发出的相同 HTTP 请求外，没有任何数据离开你的计算机。
• BigQuery 搜索为可选项。 只有在需要对 14 亿条记录进行全文搜索时才启用。

---

30 秒安装

pip install deeparchi-patent-mcp

或从源码安装：

git clone https://github.com/deeparchi-ai/patent-mcp-server.git
cd patent-mcp-server
pip install -e .

---

快速开始

运行 pip install 后，deeparchi-patent-mcp 控制台脚本就会出现在 PATH 中。 将以下内容添加到 Agent 平台的 MCP 配置中：

Claude Desktop

{
  "mcpServers": {
    "patent-mcp": {
      "command": "deeparchi-patent-mcp",
      "args": []
    }
  }
}

Cursor / Windsurf / Cline

配置与上面的 Claude Desktop 相同。

Hermes Agent

mcp_servers:
  patent-mcp:
    command: "deeparchi-patent-mcp"

BigQuery 为可选项。 未设置 GCP_PROJECT_ID 时，服务会正常启动， 基于 Web 的工具无需凭据即可使用。基于 BigQuery 的工具会返回 启用方法说明。若要启用这些工具，请添加一个环境变量：

{
  "mcpServers": {
    "patent-mcp": {
      "command": "deeparchi-patent-mcp",
      "args": [],
      "env": { "GCP_PROJECT_ID": "your-gcp-project" }
    }
  }
}

从源码检出目录运行

{
  "mcpServers": {
    "patent-mcp": {
      "command": "python",
      "args": ["-m", "server"],
      "cwd": "/path/to/patent-mcp-server/src"
    }
  }
}

---

现在向你的 Agent 提问：

"获取专利 US-7650331-B1，并总结其权利要求。"

---

包含的内容

工具	功能	需要配置？
get_patent	完整专利详情：分类、引用（X/Y/A/D）、发明人、受让人、专利族	否
get_patent_claims	专利权利要求文本——法律保护范围。通过 Google Patents 支持美国、中国和大多数国家	否
search_patents	按关键词、CPC、受让人、国家、日期范围搜索 14 亿件专利	可选 GCP

前两项可覆盖 80% 的使用场景。零成本。零配置。

中国专利搜索（v1.7.0）

中国专利的三层发现机制：

层级	后端	成本	适用场景
1. BigQuery	Google Patents Public Data	免费额度	cpc=H01L + country=CN
2. Firecrawl	网页搜索回退方案	每次查询 4 个额度	BigQuery 因特定 CPC（如 H01L25/065）产生费用而拒绝查询时
3. Google Patents	通过代理丰富详情	免费	查询所有专利详情

• 支持关键词搜索： query="芯片" + country=CN 可搜索中文和英文摘要（v1.5.2 修复）。
• 受让人筛选： assignee="BOE" + country=CN → 公司／城市级专利布局。
• CPC 分类： 使用上级 CPC 分类（H01L）可扩大中国专利覆盖范围；特定 CPC 代码（H01L25/065）会触发网页回退方案。
• 详细搜索策略和已测试的 CPC 代码请参阅 SEARCH_GUIDE.md。

---

可选：启用 BigQuery 搜索

如果需要使用 search_patents，请添加 GCP 项目：

1. 创建一个启用了 BigQuery 的 GCP 项目
2. 创建服务账号并下载 JSON 密钥
3. 设置环境变量：

   export GOOGLE_APPLICATION_CREDENTIALS="/path/to/key.json"
   export GCP_PROJECT_ID="your-project-id"
   

4. 复制包装器模板并填写你的路径：

   cp run.sh.example run.sh
   # Edit run.sh → set your GCP paths
   

BigQuery 免费额度：每月 1 TB——个人使用基本免费。

---

高级用法：团队服务（HTTP/SSE）

需要让多位成员共用一个 patent-mcp 实例？将其作为 HTTP 服务启动：

cp run-http.sh.example run-http.sh
# Edit → set GCP creds (skip if only using web tools)
PORT=8090 ./run-http.sh

团队成员使用以下命令连接：

mcp_servers:
  patent-mcp:
    url: "http://<server-ip>:8090/sse"

项目包含一个 systemd 服务模板，用于生产环境部署。

---

工作原理

┌──────────────┐     ┌───────────────────────────────────────┐
│  AI Agent    │────▶│  patent-mcp-server                    │
│  (Claude,    │     │  (runs on YOUR machine)               │
│   Cursor,    │     │                                       │
│   Hermes)    │     │  search_patents:                      │
│              │     │    ┌──────────┐    ┌───────────────┐  │
│              │     │    │ BigQuery │───▶│ Firecrawl     │  │
│              │     │    │ (primary)│    │ (CN fallback) │  │
│              │     │    └──────────┘    └───────┬───────┘  │
│              │     │                           │           │
│              │     │  get_patent / get_patent_claims:      │
│              │     │    ┌──────────────────────┐           │
│              │     │    │ Google Patents (web) │           │
│              │     │    │ → BigQuery fallback  │           │
│              │     │    └──────────────────────┘           │
└──────────────┘     └───────────────────────────────────────┘

• 通过网络抓取获取详情 — 速度快（约 1.5 秒）、免费，无需凭据
• 通过 BigQuery 搜索 — 14 亿条记录，支持 CN 全文搜索，可选
• 通过 Firecrawl 回退搜索 CN 专利 — BigQuery 因特定 CPC 查询费用过高而拒绝时启用
• 智能回退 — 每个工具都会先尝试网络搜索；如果已配置 BigQuery，则自动回退到 BigQuery

---

工具参考

get_patent

get_patent(publication_number="US-7650331-B1")

返回：分类、引用（X/Y/A/D 现有技术标记）、专利族 ID、日期、发明人、受让人。提供现有技术标记引用，便于 Agent 快速评估新颖性。

**CN 专利说明：**通过 Google Patents 网络抓取获取的 CN 专利数据为机器翻译的英文数据。网络抓取无法获取 CPC 代码（由 JS 渲染）。如需 CPC 代码，请使用 BigQuery 路径。

get_patent_claims

get_patent_claims(publication_number="US-7650331-B1")

返回：完整的权利要求文本。通过 Google Patents 网络抓取支持 US、CN（机器翻译的英文）和大多数国家/地区。

search_patents

search_patents(cpc="G06N", country="CN", after="2023-01-01", limit=5)
search_patents(assignee="TSMC", country="CN")
search_patents(query="芯片", country="CN")          # keyword search (CN: searches both EN+ZH)

按关键词、CPC 分类、受让人、国家/地区和日期范围搜索 14 亿项专利。对于 CN 专利，关键词搜索会同时检索英文和中文摘要。

**费用控制：**查询至少需要一个筛选条件（cpc/country/assignee/after）。试运行预算保护机制会拒绝超过 50 GB 的查询。当 BigQuery 拒绝 CN CPC 查询时（例如，H01L25/065 → 256 GB），网络回退机制会自动通过 Firecrawl 搜索。

最佳实践请参阅 SEARCH_GUIDE.md；已测试的 CPC 代码请参阅 docs/cn-cpc-correction-table.md。

---

开发

pip install -e ".[dev]"

pytest tests/ -v          # 32 tests, ~1.5s
ruff check src/ tests/    # lint
mypy src/                 # type check

---

许可证

MIT — 详见 LICENSE。

---

作者

DeepArchi OPC — 面向企业架构的 AI Agent 基础设施。