🚀 美国专利商标局 (USPTO) 专利 MCP 服务器

这是一个借助 Patent Public Search API 和 Open Data Portal (ODP) API 来访问 USPTO 数据的 FastMCP 服务器。它能让你便捷地获取 USPTO 的各类专利数据，为专利研究和应用提供有力支持。

🚀 快速开始

安装与配置

克隆仓库

使用以下命令克隆项目仓库：

git clone [仓库链接]
cd uspto-patent-mcp-server

环境变量设置

在项目根目录下创建并编辑 config.json 文件，添加以下内容：

{
  "api_key": "[你的 API 密钥]",
  "endpoint": "https://api.uspto.gov"
}

运行服务器

直接使用

通过命令行运行服务器：

uv run server.py

集成到 Claude Desktop

1. 打开 Claude Desktop 的开发者设置。
2. 在配置文件中添加 MCP 服务器的路径和端口信息。

✨ 主要特性

公共专利搜索 (ppubs.uspto.gov)

• ppubs_search_patents：在 USPTO 公共搜索中查找已授权的专利。
• ppubs_search_applications：在 USPTO 公共搜索中查找已发布的专利申请。
• ppubs_get_full_document：通过 GUID 从 ppubs.uspto.gov 获取完整的专利文档信息。
• ppubs_get_patent_by_number：通过编号从 ppubs.uspto.gov 获取授权专利的全文。
• ppubs_download_patent_pdf：下载 USPTO 公共搜索中的 PDF 格式专利文件（目前不被 Claude Desktop 支持）。

开放数据门户 API (api.uspto.gov)

• get_app(app_num)：获取特定专利申请的基本信息。
• search_applications(...)：使用查询参数在开放数据门户中搜索专利申请。
• download_applications(...)：下载符合查询条件的专利申请数据。
• get_app_metadata(app_num)：获取特定专利申请的元数据。
• get_app_adjustment(app_num)：获取特定专利申请的期限调整信息。
• get_app_assignment(app_num)：获取特定专利申请的转让信息。
• get_app_attorney(app_num)：获取特定专利申请的律师或代理信息。
• get_app_continuity(app_num)：获取特定专利申请的连续性信息。
• get_app_foreign_priority(app_num)：获取特定专利申请的外国优先权声明。
• get_app_transactions(app_num)：获取特定专利申请的交易历史记录。
• get_app_documents(app_num)：获取特定专利申请的文档详细信息。
• get_app_associated_documents(app_num)：获取与特定专利申请相关的其他文档。
• get_status_codes(...)：搜索状态代码。
• search_datasets(...)：在开放数据门户中搜索数据集产品。
• get_dataset_product(...)：通过标识符获取特定的数据集产品信息。

💻 使用示例

基础用法

# 克隆仓库
git clone [仓库链接]
cd uspto-patent-mcp-server

# 设置环境变量
{
  "api_key": "[你的 API 密钥]",
  "endpoint": "https://api.uspto.gov"
}

# 运行服务器
uv run server.py

高级用法

# 运行测试脚本
uv run test/test_tools.py

📚 详细文档

测试

测试脚本位于 /test/ 目录中，包括以下内容：

• test_patents.py：直接对 ppubs.uspto.gov 和 api.uspto.gov 端点进行 HTTP 请求的测试。
• test_tools.py：完整的工具功能测试套件。

运行测试：

uv run test/test_tools.py

📄 许可证

本项目采用 MIT 许可证，具体内容如下：

MIT License

版权所有 (c) [年份] [作者姓名]

允许任何人免费使用、复制、修改、合并、发布和分发此软件及其文档，以及生成的二进制文件，只要保留版权声明和本许可声明。

对于因使用或无法使用此软件而产生的任何直接或间接损害，作者概不负责。