tw-patent-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| EPO_OPS_KEY | No | EPO OPS Consumer Key | |
| EPO_OPS_SECRET | No | EPO OPS Consumer Secret | |
| GPSS_USER_CODE | No | GPSS API 驗證碼 | |
| TW_PATENT_MCP_ENV | No | 指定 .env 檔路徑 | |
| TW_PATENT_MCP_HOME | No | 本機狀態資料夾,預設 ~/.tw-patent-mcp | |
| TW_PATENT_MCP_DRY_RUN | No | 設為 1 時只回傳請求網址,不實際送出 | |
| TW_PATENT_MCP_DOWNLOAD_DIR | No | PDF 下載位置,預設 ~/.tw-patent-mcp/downloads |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| gpss_codesA | 列出 GPSS 資料庫代碼、檢索欄位代碼與輸出欄位代碼。 |
| gpss_searchA | 智慧局 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。 |
| gpss_getB | 用公開/公告號(PN)或申請號(AN)取單筆 GPSS 資料,含摘要與請求項。例:number="TW201644272A"。 |
| gpss_build_urlB | 只組出 GPSS API 網址不送出(驗證碼以 *** 取代),用來檢查條件寫法。 |
| ops_searchA | EPO OPS CQL 檢索(全球書目)。例:'ti=battery and pa=tsmc'、'pn=TW201644272'、'ipc=H01M10 and pd within "2022 2024"'。constituent 可為 biblio(含書目)或 abstract。一次最多 100 筆。預設回壓平的命中清單,raw=true 回原始 JSON。 |
| ops_biblioA | EPO OPS 書目資料(標題、申請人、發明人、優先權、IPC/CPC、引證、摘要、家族 id)。number 照公報號寫即可,例:EP1000000、TW201644272A、TWI700000B、TWM600000U、US10000000B2;程式自動轉成 docdb 格式。預設回壓平摘要,raw=true 回原始 JSON。 |
| ops_legal_statusB | EPO OPS INPADOC 法律狀態(有效、撤回、屆期、年費等事件),依家族成員列出事件日期、代碼、說明與明細。預設回壓平摘要,raw=true 回原始 JSON。 |
| ops_familyA | EPO OPS INPADOC 專利家族成員(各國公開/公告號、申請號、優先權);constituent 可為 biblio 或 legal。預設回壓平摘要,raw=true 回原始 JSON。 |
| ops_fulltextB | EPO OPS 全文:part 為 claims、description 或 abstract。全文只有 EP、WO 與部分歐洲國家。 |
| ops_registerC | 歐洲專利註冊簿(EP 案):constituent 為 biblio、events 或 procedural-steps。 |
| ops_imagesB | EPO OPS 影像清單:某件有哪些 PDF 文件(FullDocument 全件、Drawing 圖式、FirstPageClipping 首頁)與頁數。台灣、美國、歐洲等公報原件多數可取得。 |
| ops_download_pdfA | 下載 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 節流燈號自動調整。 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
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.