Patent MCP Server

🚀 美國專利商標局 (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) [年份] [作者姓名]

允許任何人免費使用、複製、修改、合併、發佈和分發此軟件及其文檔，以及生成的二進制文件，只要保留版權聲明和本許可聲明。

對於因使用或無法使用此軟件而產生的任何直接或間接損害，作者概不負責。