patent MCP server

USPTO专利MCP服务器

有关MCP服务器的介绍，请参阅 介绍模型上下文协议.

特性

此服务器提供 52工具 跨越6个USPTO数据源（20个活动，32个由于API关闭而不可用）：

1. 专利检索 -通过PPUBS对已授予的专利和已发布的申请进行全文搜索
2. 全文文档 -获取专利的完整文本，包括权利要求、描述和说明书
3. PDF下载 -将专利下载为PDF文件（Claude Desktop目前不支持将其作为客户端）
4. 起诉历史 -通过ODP访问事务和文件包装器数据
5. 专利族数据 -连续性信息、外国优先级和相关应用程序
6. 批量数据集 -搜索和访问USPTO批量数据产品，包括专利查看消歧数据

关于不可用API的说明： PatentsView API（search.Pauntsview.org）于2026年3月20日关闭，其数据迁移到ODP批量数据集。Office Action和Enriched Citation API（developer.uspto.gov）于2026年初退役。PTAB试验API和专利诉讼API根本不在USPTO开放数据门户上提供-它们不在ODP Swagger目录中列出，也没有实时终点（见 问题#16)；PTAB和诉讼数据可批量下载。所有32个受影响的工具都保持注册状态，并返回有用的解决方法指南，指出替代工具。

API来源

先决条件

• Python 3.10-3.13 （3.12推荐）
• 克劳德桌面版 （用于整合）。其他型号和MCP客户端尚未经过测试。
• 紫外线 用于Python版本和依赖关系管理

如果你是一名Python开发人员，但仍然不熟悉uv，那么你会得到一种享受。它比使用单独的Python版本管理器（如pyenv）以及使用venv和pip设置、激活和维护虚拟环境更快、更容易。

如果您还没有安装uv：

curl -LsSf https://astral.sh/uv/install.sh | sh

安装

1. 克隆此存储库：

   git clone https://github.com/riemannzeta/patent_mcp_server
   cd patent_mcp_server

1. 使用uv安装依赖项：

   uv sync

1. 验证安装：

   uv run patent-mcp-server

应输出：

   INFO     Starting USPTO Patent MCP server with stdio transport

API密钥设置

USPTO ODP API密钥（大多数工具都需要）

要使用api.uspto.gov工具（ODP），您需要一个开放数据门户api密钥。如果没有它，这些端点将返回 403 ForbiddenPTAB和诉讼工具不需要API密钥-这些API根本不在ODP上提供（见问题#16）。

1. 在以下网址创建USPTO.gov帐户 data.uspto.gov （需要ID.me验证）

1. 登录后，请访问 “我的ODP” 在站点导航中获取您的API密钥

1. 请参阅 入门指南 详细说明

1. 创建一个 .env patent_mcp_server目录中的文件：

   USPTO_API_KEY=your_actual_key_here

注：PPUBS工具将在没有此API密钥的情况下工作。

配置

服务器可以使用您的环境变量进行配置 .env 文件。所有设置都是可选的，具有合理的默认值：

# API Keys
USPTO_API_KEY=your_key_here

# Logging
LOG_LEVEL=INFO  # Options: DEBUG, INFO, WARNING, ERROR, CRITICAL

# HTTP Settings
REQUEST_TIMEOUT=30.0  # Request timeout in seconds
MAX_RETRIES=3         # Maximum number of retry attempts
RETRY_MIN_WAIT=2      # Minimum wait time between retries (seconds)
RETRY_MAX_WAIT=10     # Maximum wait time between retries (seconds)

# Session Management
SESSION_EXPIRY_MINUTES=30  # How long to cache ppubs sessions
ENABLE_CACHING=true        # Enable/disable session caching

# API Endpoints (usually don't need to change)
PPUBS_BASE_URL=https://ppubs.uspto.gov
API_BASE_URL=https://api.uspto.gov          # ODP API endpoint (NOT data.uspto.gov)

Claude桌面配置

要将此MCP服务器与Claude Desktop集成，请执行以下操作：

1. 更新您的Claude Desktop配置文件(claude_desktop_config.json):

   {
     "mcpServers": {
       "patents": {
         "command": "uv",
         "args": [
           "--directory",
           "/Users/username/patent_mcp_server",
           "run",
           "patent-mcp-server"
         ]
       }
     }
   }

你可以找到 claude_desktop_config.json 在Mac上，打开Claude Desktop应用程序，打开设置（从Claude菜单或通过键盘上的Command+'），单击侧边栏中的“开发人员”，然后单击“编辑配置”

1. 替换 /Users/username/patent_mcp_server 带有您的patent_mcp_server目录的实际路径。

当与Claude Desktop集成时，服务器将在需要时自动启动，不需要单独运行。

Claude代码配置

要将此MCP服务器与特定项目的Claude Code集成，请从项目根目录开始：

claude mcp add-json patents '{"command": "uv", "args": ["--directory", "/path/to/patent_mcp_server", "run", "patent-mcp-server"]}'

如果您已经在运行Claude Code，则必须退出并重新启动。然后/mcp验证它是否已配置。

可用工具

实用工具

专利公开检索（ppubs.uspto.gov）

开放数据门户（api.uspto.gov）

PTAB API试用版（不可用-ODP上未提供，第16期）

所有7个PTAB工具返回 API_UNAVAILABLE。PTAB试用版API未在ODP Swagger目录中列出 developer.uspto.gov 退休了。PTAB批量数据可在 .

专利诉讼API（不可用-未在ODP上提供，问题#16）

所有4个诉讼工具返回 API_UNAVAILABLE专利诉讼API未列入ODP Swagger目录。OCE专利诉讼数据集（74000多个地区法院案件）以批量下载的形式分发，网址为 .

PatentsView API（不可用-2026年3月关闭）

全部14专利查看工具返回 API_UNAVAILABLE 有变通方法指导。PatentsView数据已作为批量可下载数据集迁移到USPTO开放数据门户。使用 ppubs_search_patents 对于专利检索， odp_search_datasets 以查找批量数据集。

Office Action API（不可用，2026年初停用）

所有4个Office Action工具返回 API_UNAVAILABLE.使用 odp_get_documents 从文件包装器访问office操作文档。

增强引用API（不可用，2026年初退役）

所有3个强化引文工具返回 API_UNAVAILABLE.使用 odp_get_documents 或 ppubs 工具作为变通方法。

资源和提示

服务器还提供 MCP资源 （可通过@提及访问）：

• patents://cpc/{code} -CPC分类信息
• patents://status-codes -美国专利商标局状态代码定义
• patents://sources -数据源信息
• patents://search-syntax -查询语法指南

和 MCP提示 （工作流模板）：

• prior_art_search -全面的现有技术搜索指南
• patent_validity -专利有效性分析工作流程
• competitor_portfolio -竞争对手投资组合分析
• ptab_research -PTAB程序研究指南
• freedom_to_operate -FTO分析工作流程
• patent_landscape -技术景观图

测试

该项目包括全面的测试套件：

# Run unit tests (default - skips integration tests)
uv run pytest

# Run with verbose output
uv run pytest -v

# Run integration tests (requires network access)
uv run pytest -m integration

# Run all tests including integration
uv run pytest -m ""

# Run with coverage report
uv run pytest --cov=patent_mcp_server

测试结果存储在 /test/test_results/.

发展

要安装开发依赖项，请执行以下操作：

uv sync --dev

发布到PyPI

# Build distribution packages
rm -rf dist/ && uv run python -m build

# Upload to PyPI
uv run twine upload dist/*

版本历史

v0.9.0（当前）

• 处理PTAB审判API和专利诉讼API在ODP上不可用(问题#16)
• 全部7 ptab_* 工具和4个诉讼工具现在返回 API_UNAVAILABLE 变通指南指向PPUBS工具和USPTO批量数据集
• 活动刀具数：20（低于31）；不可用：32（高于21）；登记总数仍为52
• 为所有11个新不可用的工具添加了单元测试，并扩展了共享错误结构参数化
• 已更新 check_api_status, resources.py 数据源、客户端文档字符串和README，以反映关机情况

v0.8.0

• 处理退役专利查看API（2026年3月20日关闭）
• 全部14 patentsview_* 工具归还 API_UNAVAILABLE 有变通方法指导
• 修复了office_actions资源中指向不可用PatentsView工具的循环引用
• 更新了API源表、配置和文档

v0.7.0

• 处理退役的Office Action和增强引用API（developer.uspto.gov）
• 所有7个受影响的工具均已退回 API_UNAVAILABLE 有变通方法指导
• 添加 test/unit/test_unavailable_tools.py 用于退役工具测试
• 代码清理：删除死代码，改进文档字符串

v0.6.2

• 更新的API密钥注册说明：密钥现在从 data.uspto.gov （“我的ODP”）
• 澄清了这一点 api.uspto.gov 是正确的API端点（不是 data.uspto.gov 哪个是门户网站）
• 注意到PTAB API v3迁移到ODP和Office Action API迁移（2026年初）

v0.6.1

• 新增专利查看律师搜索工具(patentsview_search_attorneys, patentsview_get_attorney)
• 新增专利查看IPC分类工具(patentsview_lookup_ipc, patentsview_search_by_ipc)
• 修复了中的错误 search_publications 方法（未传递分页选项）

v0.6.0

• PyPI释放准备

v0.5.0

• 专注于仅美国专利商标局的数据来源
• 将ODP工具重命名为 odp_ 为清楚起见，使用前缀
• 改进的函数签名（使用 query 而不是 q)

v0.3.0

• 新增33个工具（PTAB、PatentsView、办公室诉讼、引文、诉讼）
• 对专利的速率限制支持查看API
• 全面的异步客户端架构

v0.2.2

• 具有环境变量的集中配置
• 标准化错误处理
• 使用Pydantic进行输入验证
• 使用指数回退重试逻辑
• PPUBS的会话缓存

许可证

麻省理工学院