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 集成