Taiwan Patent MCP

io.github.aa0101181514由 GitHub 帳號 aa0101181514 發布v0.2.0更新於 Nov 4, 2026

Patent search via Taiwan IPO GPSS and EPO OPS: legal status, families, full text, PDFs

發布方自己的服務:Patent Connector

概覽

AI 產生的概覽

專利檢索 MCP 伺服器,讓助理查詢台灣智慧局 GPSS 與 EPO OPS 的書目、法律狀態、專利家族、全文與 PDF。

可以做什麼
  • 列出 GPSS 資料庫、檢索欄位與輸出欄位代碼,並只組出請求網址而不送出
  • 跨 23 個 GPSS 資料庫檢索書目、摘要與請求項,並以公告號或申請號取單筆資料
  • 執行 EPO OPS CQL 檢索,取得書目資料、INPADOC 法律狀態與專利家族成員
  • 讀取 EP/WO 全文與歐洲專利註冊簿資料
  • 列出可用的影像文件與頁數,並下載、合併公報 PDF
適用情境
適合專利調研:查閱台灣或全球的申請案、請求項與摘要,追蹤法律狀態或家族成員,或取得公報原件 PDF。適用於先前技術檢索與自由實施分析,而非一般網頁搜尋。
執行需求
透過 uvx 在本機執行(需要 uv)。兩組選用憑證,皆免費但須自行申請:GPSS_USER_CODE 用於台灣智慧局 GPSS API,EPO_OPS_KEY 與 EPO_OPS_SECRET 用於 EPO OPS。只設定其中一組,對應工具即可運作。憑證可放在環境變數或本機 .env 檔。需要能連線這兩個服務的網路。
安裝前請注意
需自備 API 憑證,套件不提供共用憑證。GPSS 驗證碼效期 365 日,驗證碼無效或 IP 被擋時會寫入鎖檔並停止後續呼叫,須手動刪除才能恢復。EPO OPS 每週 4GB 額度並有每分鐘呼叫限制;PDF 每頁計一次呼叫,下載前應先確認頁數。下載會在本機目錄寫入檔案。資料僅供參考,須遵守兩局的條款。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Taiwan Patent MCP,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

tw-patent-mcp

English

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

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

需要自備的憑證

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

變數取得方式
GPSS_USER_CODE至 GPSS API 說明頁 線上申請驗證碼。審核通過後以 Email 寄送,效期 365 日。
EPO_OPS_KEY、EPO_OPS_SECRET至 EPO Developer Portal 註冊,核准後在 My Apps 建立 app 取得 Consumer Key 與 Secret。

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

安裝

需要 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:

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。

設定

環境變數說明
GPSS_USER_CODEGPSS API 驗證碼
EPO_OPS_KEY、EPO_OPS_SECRETEPO OPS Consumer Key 與 Secret
TW_PATENT_MCP_HOME本機狀態資料夾,預設 ~/.tw-patent-mcp
TW_PATENT_MCP_DOWNLOAD_DIRPDF 下載位置,預設 ~/.tw-patent-mcp/downloads
TW_PATENT_MCP_ENV指定 .env 檔路徑
TW_PATENT_MCP_DRY_RUN設為 1 時只回傳請求網址,不實際送出

工具

工具來源用途
gpss_codesGPSS列出資料庫、檢索欄位與輸出欄位代碼
gpss_searchGPSS跨 23 個資料庫檢索書目、摘要與請求項
gpss_getGPSS以公開公告號或申請號取得單筆資料
gpss_build_urlGPSS只組出請求網址,用來檢查檢索條件
ops_searchEPO OPSCQL 全球書目檢索,回傳總筆數與命中清單
ops_biblioEPO OPS書目資料:標題、申請人、發明人、優先權、IPC/CPC、引證、摘要
ops_legal_statusEPO OPSINPADOC 法律狀態,依家族成員列事件
ops_familyEPO OPSINPADOC 專利家族成員清單
ops_fulltextEPO OPS請求項、說明書、摘要全文,限 EP、WO 與部分歐洲國家
ops_registerEPO OPS歐洲專利註冊簿
ops_imagesEPO OPS列出公報原件、圖式、首頁等影像文件與頁數
ops_download_pdfEPO OPS逐頁下載公報 PDF,多頁自動合併

專利號照公報寫法輸入即可,例如 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 syncuv run pytest -q

授權

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

來源:README.md,提交 45d6e30

工具

12

gpss_codes

列出 GPSS 資料庫代碼、檢索欄位代碼與輸出欄位代碼。

無需輸入參數。

gpss_get

用公開/公告號(PN)或申請號(AN)取單筆 GPSS 資料,含摘要與請求項。例:number="TW201644272A"。

輸入參數bynumber必填databases

gpss_build_url

只組出 GPSS API 網址不送出(驗證碼以 *** 取代),用來檢查條件寫法。

輸入參數qtykindskipoutputstatusdatabasesconditions必填

ops_biblio

EPO OPS 書目資料(標題、申請人、發明人、優先權、IPC/CPC、引證、摘要、家族 id)。number 照公報號寫即可,例:EP1000000、TW201644272A、TWI700000B、TWM600000U、US10000000B2;程式自動轉成 docdb 格式。預設回壓平摘要,raw=true 回原始 JSON。

輸入參數fmtrawnumber必填

ops_family

EPO OPS INPADOC 專利家族成員(各國公開/公告號、申請號、優先權);constituent 可為 biblio 或 legal。預設回壓平摘要,raw=true 回原始 JSON。

輸入參數fmtrawnumber必填constituent

ops_fulltext

EPO OPS 全文:part 為 claims、description 或 abstract。全文只有 EP、WO 與部分歐洲國家。

輸入參數fmtpartnumber必填

ops_register

歐洲專利註冊簿(EP 案):constituent 為 biblio、events 或 procedural-steps。

輸入參數fmtnumber必填constituent

ops_images

EPO OPS 影像清單:某件有哪些 PDF 文件(FullDocument 全件、Drawing 圖式、FirstPageClipping 首頁)與頁數。台灣、美國、歐洲等公報原件多數可取得。

輸入參數fmtnumber必填

ops_download_pdf

下載 EPO OPS 影像 PDF。link 用 ops_images 回傳的 link(如 published-data/images/EP/1000000/A1/fullimage),pages 如 '1-5' 或 'all'(需給 max_pages)。每頁一次呼叫並算入每週 4GB,先用 ops_images 看頁數再決定範圍。檔案存到 TW_PATENT_MCP_DOWNLOAD_DIR(預設 ~/.tw-patent-mcp/downloads),多頁自動合併。呼叫間隔依 OPS 節流燈號自動調整。

輸入參數link必填mergepagesmax_pages

版本歷史

2
  1. v0.2.0最新Oct 21, 2026
  2. v0.1.1Oct 20, 2026

評分

已滿足適用檢查項的 80%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分
  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。

其他 Patent 整合