patents-mcp-server

patents-mcp-server

基于 FastMCP TypeScript 构建的专利情报 MCP 服务。提供 45 个工具，覆盖 USPTO、EPO 和 Google Patents，适用于 IP 全景分析、自由实施研究和专利监控。

注意： PatentsView 支持已于 2026 年 5 月移除——其 API 主机 search.patentsview.org 于 2026-03-20 停用；PatentsView 迁移至 USPTO ODP 后，仅以批量下载数据集的形式提供（没有实时 API 替代方案）。现在可通过 Google BigQuery 进行美国专利全文搜索，通过 USPTO ODP 获取书目数据。有关方案分析，请参阅 docs/MCP_PLAN-PatentsView-Rehoming_2026-05-30.md。

数据来源

来源	工具数	主要能力
USPTO ODP	30	申请、文档 PDF 下载、PTAB、引证、诉讼、审查意见
EPO OPS	8	INPADOC 专利家族、约 44 个局的法律状态、权利要求／说明书
Google BigQuery	4	搜索 9,000 万多项专利的全文、引证网络、CPC 分析

仅在配置了所需 API 密钥时才会注册相应工具，避免无效工具干扰 MCP 客户端。

快速开始

pnpm install
cp .env.example .env    # Add your API keys
pnpm build

通过 stdio 运行（Claude Desktop / Claude Code）

node dist/index.js

通过 HTTP 运行（远程部署）

TRANSPORT=httpStream PORT=8080 node dist/index.js

MCP 配置（.mcp.json）

{
  "mcpServers": {
    "patents": {
      "command": "node",
      "args": ["dist/index.js"],
      "env": {
        "USPTO_API_KEY": "${USPTO_API_KEY}",
        "EPO_CONSUMER_KEY": "${EPO_CONSUMER_KEY}",
        "EPO_CONSUMER_SECRET": "${EPO_CONSUMER_SECRET}",
        "GOOGLE_APPLICATION_CREDENTIALS": "${GOOGLE_APPLICATION_CREDENTIALS}",
        "GOOGLE_CLOUD_PROJECT": "${GOOGLE_CLOUD_PROJECT}"
      }
    }
  }
}

使用 MCP Inspector 测试

npx @modelcontextprotocol/inspector node dist/index.js

配置

API 密钥

来源	环境变量	获取途径
USPTO ODP	USPTO_API_KEY	data.uspto.gov → MyODP
EPO OPS	EPO_CONSUMER_KEY + EPO_CONSUMER_SECRET	developers.epo.org
BigQuery	GOOGLE_APPLICATION_CREDENTIALS + GOOGLE_CLOUD_PROJECT	GCP Console（具有 BigQuery 角色的服务账号）

缺少 API 密钥时，相关工具会正常停用；服务仍会使用已配置的数据源启动。使用 check-api-status 工具可确认哪些数据源可用。

使用 envpkt 管理凭据

本项目使用 envpkt 管理凭据。API 密钥以密封（age 加密）数据包的形式存储，非机密配置则作为 [env.*] 条目存储在 envpkt.toml 中。.mcp.json 使用 ${VAR} 语法引用环境变量，这些变量由 shell 配置文件中的 eval "$(envpkt env export)" 加载。

路径扩展

GOOGLE_APPLICATION_CREDENTIALS 支持通过 functype-os 展开波浪号（~）和环境变量（$HOME、${HOME}）。可使用 ~/.config/gcloud/key.json 这类路径，而不必使用绝对路径。

BigQuery 费用说明

• 免费额度：每月扫描查询数据 1TB
• 对 9,000 万项专利进行宽泛的全文搜索，每次查询会扫描约 200–300GB
• 定向查询（专利号、家族、带日期范围的 CPC）扫描的数据要少得多
• 每次查询都会先进行试运行；响应中会包含预估费用

工具

USPTO ODP（13 个工具）

USPTO 官方开放数据门户——申请、审查历史、转让、文档。

• odp-search-applications — 搜索专利申请（2001 年及以后）
• odp-get-application / metadata / continuity / assignment / adjustment / attorney / foreign-priority / transactions / documents
• odp-download-document — 将文件卷宗文档下载为 PDF（通过服务使用自身密钥代理经身份验证的获取请求）
• odp-search-datasets / get-dataset — 批量数据产品

PTAB（7 个工具）

授权后程序——IPR、PGR、CBM、单方复审。

• ptab-search-proceedings / get-proceeding / get-documents
• ptab-search-decisions / get-decision
• ptab-search-appeals / get-appeal

引证与诉讼（6 个工具）

专利引证和诉讼数据。

• citations-get-enriched / search / get-metrics
• litigation-search / get-case / get-patent

EPO OPS（8 个工具）

欧洲专利局——国际覆盖范围、INPADOC 专利族、法律状态。

• epo-search-patents — CQL 搜索（标题、摘要、申请人、发明人、CPC、日期）
• epo-get-biblio / abstract / claims / description — 专利文档章节
• epo-family-lookup — 查询所有司法管辖区内的 INPADOC 专利族成员
• epo-legal-status — 查询约 44 个专利局的法律状态
• epo-number-convert — 转换不同的编号格式

Google BigQuery（4 个工具）

在 9,000 多万份专利文档中进行全文搜索。取代 PPUBS 的权利要求搜索功能。

• bigquery-patent-search — 在标题和摘要中进行全文搜索
• bigquery-patent-family — 按 INPADOC 专利族 ID 查询专利族成员
• bigquery-citation-network — 引证图（深度 1 或 2）
• bigquery-cpc-analytics — 按 CPC 分类统计申请数据

审查意见通知书（4 个工具）

USPTO 审查意见通知书数据（将在 2026 年迁移至 ODP）。

• office-action-get-text / search / get-citations / get-rejections

实用工具（3 个工具）

• check-api-status — 检查所有已配置 API 的运行状态
• get-cpc-info — 查询 CPC 分类信息
• get-status-code — 查询 USPTO 状态代码含义

提示词

针对常见专利分析任务的六个工作流提示词模板：

提示词	用途
prior_art_search	多来源现有技术搜索工作流
patent_validity	结构化有效性分析（102/103/112）
competitor_portfolio	竞争对手专利组合分析
ptab_research	PTAB 程序研究（IPR/PGR/CBM）
freedom_to_operate	FTO 分析方法
patent_landscape	技术领域全景图绘制

资源

URI	描述
patents://cpc/{code}	CPC 分类信息
patents://status-codes	USPTO 状态代码定义
patents://sources	数据来源概览
patents://search-syntax	查询语法指南（EPO CQL、ODP、BigQuery）

开发

pnpm validate        # Format + lint + typecheck + test + build
pnpm test            # Run tests
pnpm build           # Production build
pnpm typecheck       # Type check only
pnpm codegen         # Regenerate Zod schemas from OpenAPI specs
pnpm fetch-specs     # Re-download OpenAPI specs from upstream

OpenAPI 代码生成

响应架构使用带有 Zod 插件的 Hey API，根据上游 OpenAPI 规范生成：

pnpm fetch-specs     # Download USPTO ODP spec
pnpm codegen         # Generate src/generated/odp/zod.gen.ts

生成的代码会提交到仓库，因此 CI 无需执行代码生成步骤。

测试

有可用凭据时，集成测试会针对实时 API 运行：

# Requires USPTO_API_KEY in env
pnpm test

缺少 API 密钥时，测试会自动跳过。

架构

基于 FastMCP + Zod + ts-builds + functype-os 构建。

src/
├── index.ts                    # Entry point
├── server.ts                   # FastMCP instance
├── tools/                      # 45 tools across 7 modules (conditional registration)
├── clients/                    # API clients (base, ODP, EPO, BigQuery)
├── generated/                  # Zod schemas from OpenAPI specs (Hey API codegen)
├── specs/                      # Local copies of OpenAPI specs
├── resources/                  # 4 MCP resources
├── prompts/                    # 6 prompt templates
└── lib/                        # Config, retry, errors, patent number normalization

许可证

MIT

致谢

• USPTO — 美国专利商标局
• EPO OPS — 欧洲专利局开放专利服务
• Google Patents Public Data — BigQuery 专利数据集

---

由 SapientsAI 赞助 — 为企业打造 Agentic AI