Taiwan Patent MCP

tw-patent-mcp

English

專利檢索 MCP 伺服器，串接經濟部智慧財產局全球專利檢索系統（GPSS）API 與歐洲專利局 Open Patent Services（EPO OPS）。

• GPSS：一次檢索台灣、美國、日本、歐洲、韓國、中國、WIPO 等 23 個資料庫的書目、摘要與請求項。
• EPO OPS：全球書目、INPADOC 法律狀態、專利家族、EP 與 WO 全文、歐洲專利註冊簿，以及公報原件 PDF。
• 伺服器端不呼叫任何語言模型，只做查詢、格式轉換與錯誤防護。

需要自備的憑證

兩組憑證都免費，需由使用者本人申請。本套件不提供共用憑證。

只設定其中一組也可以使用，對應的工具才會運作。

安裝

需要 uv。

Claude Code：

claude mcp add tw-patent \
  -e GPSS_USER_CODE=你的驗證碼 \
  -e EPO_OPS_KEY=你的key \
  -e EPO_OPS_SECRET=你的secret \
  -- uvx tw-patent-mcp

Claude Desktop 的 claude_desktop_config.json：

{
  "mcpServers": {
    "tw-patent": {
      "command": "uvx",
      "args": ["tw-patent-mcp"],
      "env": {
        "GPSS_USER_CODE": "你的驗證碼",
        "EPO_OPS_KEY": "你的key",
        "EPO_OPS_SECRET": "你的secret"
      }
    }
  }
}

不想把憑證寫進設定檔時，可改放在 ~/.config/tw-patent-mcp/.env，格式見 .env.example。

設定

工具

專利號照公報寫法輸入即可，例如 TW201644272A、TWI700000B、TWM600000U、US10000000B2、EP1000000。

ops_search、ops_biblio、ops_legal_status、ops_family 預設回傳壓平後的摘要，體積約為原始回應的一成到兩成；需要完整欄位時加 raw=true。

使用限制與防護

• GPSS 依上班、下班時段設有輸出筆數上限，超過會回傳提示文字。
• GPSS 回應驗證碼無效、過期或 IP 被擋時，本套件會寫入鎖檔並停止後續呼叫，避免持續以無效驗證碼查詢而遭封鎖。確認驗證碼可用後，刪除 ~/.tw-patent-mcp/gpss_lock 即可恢復。新核發的驗證碼可能要隔日才生效。
• EPO OPS 免費額度為每週 4GB，並有每分鐘呼叫次數限制。本套件依 OPS 每次回應的節流燈號自動調整呼叫間隔，尚未取得燈號前每次間隔 6 秒。PDF 每頁計一次呼叫，下載前請先用 ops_images 確認頁數。

資料來源與使用責任

• 資料分別來自經濟部智慧財產局與歐洲專利局，僅供參考，請以各國專利局公告為準。
• 使用者須自行遵守智慧財產局對 GPSS 及網站資料的相關規定，以及 EPO OPS Terms and Conditions 與 Fair use charter。
• 本套件與智慧財產局、歐洲專利局無隸屬或背書關係。

開發

uv sync
uv run pytest -q

授權

Elastic License 2.0。本專案為公開原始碼，非開放原始碼授權。