This MCP server lets you search and retrieve patent data from Taiwan's GPSS and EPO OPS, including bibliographic, legal, family, full-text, image, and PDF-download workflows.
List GPSS database/field/output codes and build GPSS query URLs without sending requests.
Search GPSS across up to 23 patent databases and fetch single records by publication or application number, including abstracts and claims.
Run EPO OPS CQL global bibliographic searches and retrieve biblio data, INPADOC legal status, patent family members, and full text for EP/WO cases.
Access EPO register data, list available patent images/PDFs with page counts, and download/merge PDFs to a local directory.
Use either GPSS or EPO OPS independently when its corresponding credentials are configured.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@tw-patent-mcp search Taiwan patents for TSMC semiconductor packaging"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
專利檢索 MCP 伺服器，串接經濟部智慧財產局全球專利檢索系統（GPSS）API 與歐洲專利局 Open Patent Services（EPO OPS）。
GPSS：一次檢索台灣、美國、日本、歐洲、韓國、中國、WIPO 等 23 個資料庫的書目、摘要與請求項。
EPO OPS：全球書目、INPADOC 法律狀態、專利家族、EP 與 WO 全文、歐洲專利註冊簿，以及公報原件 PDF。
伺服器端不呼叫任何語言模型，只做查詢、格式轉換與錯誤防護。
兩組憑證都免費，需由使用者本人申請。本套件不提供共用憑證。
變數 | 取得方式 |
| 至 GPSS API 說明頁 線上申請驗證碼。審核通過後以 Email 寄送，效期 365 日。 |
| 至 EPO Developer Portal 註冊，核准後在 My Apps 建立 app 取得 Consumer Key 與 Secret。 |
只設定其中一組也可以使用，對應的工具才會運作。
Related MCP server: mcp-epo-ops
需要 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-mcpClaude 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。
環境變數 | 說明 |
| GPSS API 驗證碼 |
| EPO OPS Consumer Key 與 Secret |
| 本機狀態資料夾，預設 |
| PDF 下載位置，預設 |
| 指定 .env 檔路徑 |
| 設為 |
工具 | 來源 | 用途 |
| GPSS | 列出資料庫、檢索欄位與輸出欄位代碼 |
| GPSS | 跨 23 個資料庫檢索書目、摘要與請求項 |
| GPSS | 以公開公告號或申請號取得單筆資料 |
| GPSS | 只組出請求網址，用來檢查檢索條件 |
| EPO OPS | CQL 全球書目檢索，回傳總筆數與命中清單 |
| EPO OPS | 書目資料：標題、申請人、發明人、優先權、IPC/CPC、引證、摘要 |
| EPO OPS | INPADOC 法律狀態，依家族成員列事件 |
| EPO OPS | INPADOC 專利家族成員清單 |
| EPO OPS | 請求項、說明書、摘要全文，限 EP、WO 與部分歐洲國家 |
| EPO OPS | 歐洲專利註冊簿 |
| EPO OPS | 列出公報原件、圖式、首頁等影像文件與頁數 |
| EPO 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 sync
uv run pytest -qElastic License 2.0。本專案為公開原始碼，非開放原始碼授權。
只組出 GPSS API 網址不送出（驗證碼以 *** 取代），用來檢查條件寫法。
Inputs: conditions (required), qty, kind, skip, +3 more. Returns: result
列出 GPSS 資料庫代碼、檢索欄位代碼與輸出欄位代碼。
Inputs: no named parameters. Returns: result
用公開/公告號（PN）或申請號（AN）取單筆 GPSS 資料，含摘要與請求項。例：number="TW201644272A"。
Inputs: number (required), by, databases. Returns: result
智慧局 GPSS 檢索。conditions 是 {欄位代碼: 條件}，例如 {"TI/AB": "固態電池 or solid state battery", "AX": "台灣積體電路", "ID": "20200101:"}；欄位代碼前加 + 表示跨欄位 OR、加 - 表示 NOT。databases 例如 ["TWA","TWB"]，空＝全部 23 庫。status：A 公開／B 公告；kind：I 發明／M 新型／D 設計。output 預設 PN,ID,AN,AD,TI,PA,IN,IC,AB，要請求項加 CL。
Inputs: conditions (required), qty, kind, skip, +3 more. Returns: result
EPO OPS 書目資料（標題、申請人、發明人、優先權、IPC/CPC、引證、摘要、家族 id）。number 照公報號寫即可，例：EP1000000、TW201644272A、TWI700000B、TWM600000U、US10000000B2；程式自動轉成 docdb 格式。預設回壓平摘要，raw=true 回原始 JSON。
Inputs: number (required), fmt, raw. Returns: result
下載 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 節流燈號自動調整。
Inputs: link (required), merge, pages, max_pages. Returns: result
EPO OPS INPADOC 專利家族成員（各國公開／公告號、申請號、優先權）；constituent 可為 biblio 或 legal。預設回壓平摘要，raw=true 回原始 JSON。
Inputs: number (required), fmt, raw, constituent. Returns: result
EPO OPS 全文：part 為 claims、description 或 abstract。全文只有 EP、WO 與部分歐洲國家。
Inputs: number (required), fmt, part. Returns: result
EPO OPS 影像清單：某件有哪些 PDF 文件（FullDocument 全件、Drawing 圖式、FirstPageClipping 首頁）與頁數。台灣、美國、歐洲等公報原件多數可取得。
Inputs: number (required), fmt. Returns: result
EPO OPS INPADOC 法律狀態（有效、撤回、屆期、年費等事件），依家族成員列出事件日期、代碼、說明與明細。預設回壓平摘要，raw=true 回原始 JSON。
Inputs: number (required), fmt, raw. Returns: result
歐洲專利註冊簿（EP 案）：constituent 為 biblio、events 或 procedural-steps。
Inputs: number (required), fmt, constituent. Returns: result
EPO OPS CQL 檢索（全球書目）。例：'ti=battery and pa=tsmc'、'pn=TW201644272'、'ipc=H01M10 and pd within "2022 2024"'。constituent 可為 biblio（含書目）或 abstract。一次最多 100 筆。預設回壓平的命中清單，raw=true 回原始 JSON。
Inputs: cql (required), end, raw, start, +1 more. Returns: result
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 12 tools
The set is clearly split into Taiwan GPSS and EPO OPS namespaces, and most tools target distinct operations such as search, single-record retrieval, legal status, family, fulltext, images, and PDF download. Minor overlap exists between gpss_search/ops_search for Taiwan publications and between ops_biblio/ops_register for EP bibliographic data, but the descriptions generally make the intended use clear.
All names use a consistent prefix plus snake_case convention (gpss_* and ops_*), which makes the tool family easy to identify. However, the suffixes mix verb-style and noun-style names (e.g. ops_search vs ops_biblio), so it is not a uniform verb_noun pattern throughout.
With 12 tools, the server is well scoped for a patent search and retrieval system covering two data sources. Each tool has a distinct role, including the helper gpss_build_url and the paired ops_images/ops_download_pdf workflow.
The surface covers the main patent research lifecycle: searching, browsing codes/fields, retrieving single records, bibliographic data, legal status, families, fulltext, register data, image lists, and PDF downloads. There are no obvious dead ends for the stated Taiwan GPSS plus EPO OPS retrieval purpose.
EPO/USPTO search, citations, OCR, plus PATSTAT Portfolio Analytics, guarded SQL and Graph Analytics.
Public patent search with ranked candidates, source links and coverage context. Developer beta.
Global patent search, briefs, similarity, citations and landscape stats. Strong China coverage.
Patent search, USPTO data, patent landscape & pgvector prior-art search for agents.