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_urlA | 只組出 GPSS API 網址不送出（驗證碼以 *** 取代），用來檢查條件寫法。 |
| ops_searchB | EPO OPS CQL 檢索（全球書目）。例：'ti=battery and pa=tsmc'、'pn=TW201644272'、'ipc=H01M10 and pd within "2022 2024"'。constituent 可為 biblio（含書目）或 abstract。一次最多 100 筆。 |
| ops_biblioB | EPO OPS 書目資料（含 IPC/CPC、申請人、引證、家族 id）。number 照公報號寫即可，例：EP1000000、TW201644272A、TWI700000B、TWM600000U、US10000000B2；程式自動轉成 docdb 格式。 |
| ops_legal_statusC | EPO OPS INPADOC 法律狀態（有效、撤回、屆期、年費等事件）。 |
| ops_familyC | EPO OPS INPADOC 專利家族；constituent 可為 biblio 或 legal。每秒最多 1 次。 |
| 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），多頁自動合併。 |
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
Most tools have clearly distinct purposes, aided by two source prefixes: ops_* for EPO OPS and gpss_* for TIPO GPSS. Minor overlap exists between ops_search/ops_biblio (search vs. retrieve bibliographic data) and ops_legal_status/ops_register/ops_family-legal (legal status vs. register events vs. family legal data), but descriptions help disambiguate.
All names use lowercase snake_case and a consistent source prefix (ops_ or gpss_). The set mixes noun-style (ops_biblio, gpss_codes) and verb-style (ops_download_pdf, gpss_build_url) names, so it is not a uniform verb_noun pattern, but it is readable and predictable.
12 tools is within the well-scoped range and covers two patent data sources plus helper utilities. Each tool appears to earn its place, with no excessive duplication.
The surface covers search, retrieval, full text, images, legal status, family, and register data for EP and GPSS records. Minor gaps include no Taiwan full-description retrieval and no bulk export, but core read-only workflows are covered.