Taiwan Patent MCP

tw-patent-mcp

英語

特許検索 MCP サーバーです。経済部智慧財產局の全球專利檢索系統（GPSS）API と欧州特許庁の Open Patent Services（EPO OPS）を接続します。

• GPSS：台湾、米国、日本、欧州、韓国、中国、WIPO など、23 のデータベースから書誌、要約、請求項を一括検索します。
• EPO OPS：世界の書誌、INPADOC 法的状態、特許ファミリー、EP および WO の全文、欧州特許登録簿、公報原本の PDF を提供します。
• サーバー側では言語モデルを一切呼び出さず、検索、形式変換、エラー防止のみを行います。

各自で用意する認証情報

2 種類の認証情報はいずれも無料で、利用者本人による申請が必要です。本パッケージでは共有認証情報を提供していません。

変数	取得方法
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：

{
  "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_CODE	GPSS API 認証コード
EPO_OPS_KEY、EPO_OPS_SECRET	EPO OPS Consumer Key と Secret
TW_PATENT_MCP_HOME	ローカルの状態データフォルダー。既定値は ~/.tw-patent-mcp です
TW_PATENT_MCP_DOWNLOAD_DIR	PDF のダウンロード先。既定値は ~/.tw-patent-mcp/downloads です
TW_PATENT_MCP_ENV	.env ファイルのパスを指定します
TW_PATENT_MCP_DRY_RUN	1 に設定すると、リクエスト URL のみを返し、実際には送信しません

ツール

ツール	ソース	用途
gpss_codes	GPSS	データベース、検索フィールド、出力フィールドのコードを一覧表示します
gpss_search	GPSS	23 のデータベースを横断して、書誌、要約、請求項を検索します
gpss_get	GPSS	公開公報番号または出願番号で単一のレコードを取得します
gpss_build_url	GPSS	リクエスト URL のみを組み立て、検索条件の確認に使用します
ops_search	EPO OPS	CQL による世界の書誌検索を行い、総件数と該当リストを返します
ops_biblio	EPO OPS	書誌情報：タイトル、出願人、発明者、優先権、IPC/CPC、引用、要約
ops_legal_status	EPO OPS	INPADOC 法的状態。ファミリーメンバーごとにイベントを表示します
ops_family	EPO OPS	INPADOC 特許ファミリーメンバーの一覧
ops_fulltext	EPO OPS	請求項、明細書、要約の全文。EP、WO、および一部の欧州諸国に限定されます
ops_register	EPO OPS	欧州特許登録簿
ops_images	EPO OPS	公報原本、図面、表紙などの画像文書とページ数を一覧表示します
ops_download_pdf	EPO OPS	公報 PDF をページごとにダウンロードし、複数ページの場合は自動で結合します

特許番号は公報に記載されている形式のまま入力できます。例：TW201644272A、TWI700000B、TWM600000U、US10000000B2、EP1000000。

ops_search、ops_biblio、ops_legal_status、ops_family は、既定でフラット化した要約を返します。データ量は元のレスポンスの約 10～20％です。完全なフィールドが必要な場合は raw=true を指定してください。

使用制限と保護機能

• GPSS は営業時間内外に応じて出力件数の上限を設けており、上限を超えると案内文が返されます。
• GPSS から認証コードが無効、期限切れ、または IP がブロックされているという応答があった場合、本パッケージはロックファイルを書き込み、以降の呼び出しを停止します。無効な認証コードで検索を続けてブロックされるのを防ぐためです。認証コードが有効であることを確認した後、~/.tw-patent-mcp/gpss_lock を削除すると再開できます。新しく発行された認証コードは、翌日まで有効にならない場合があります。
• EPO OPS の無料利用枠は週 4GB で、1 分あたりの呼び出し回数にも制限があります。本パッケージは OPS の各レスポンスに含まれる節流ランプに応じて、呼び出し間隔を自動調整します。ランプを取得するまでは、呼び出し間隔は毎回 6 秒です。PDF は 1 ページにつき 1 回の呼び出しとしてカウントされるため、ダウンロード前に ops_images でページ数を確認してください。

データソースと利用者の責任

• データは経済部智慧財產局および欧州特許庁から提供されており、参考情報としてのみご利用ください。各国の特許庁による公示を優先してください。
• 利用者は、智慧財產局が定める GPSS およびウェブサイトデータに関する規定、ならびに EPO OPS の Terms and Conditions と Fair use charter を自ら遵守する必要があります。
• 本パッケージは智慧財產局および欧州特許庁とは無関係であり、両機関からの推奨を受けていません。

開発

uv sync
uv run pytest -q

ライセンス

Elastic License 2.0。本プロジェクトはソースコードを公開していますが、オープンソースライセンスではありません。