🚀 美国专利商标局 (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
- 打开 Claude Desktop 的开发者设置。
- 在配置文件中添加 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) [年份] [作者姓名]
允许任何人免费使用、复制、修改、合并、发布和分发此软件及其文档，以及生成的二进制文件，只要保留版权声明和本许可声明。
对于因使用或无法使用此软件而产生的任何直接或间接损害，作者概不负责。