patents-mcp-server

patents-mcp-server

FastMCP TypeScript 製の特許インテリジェンス MCP サーバーです。USPTO、EPO、Google Patents にわたる 45 個のツールを備え、知的財産の状況分析、実施自由性調査、特許モニタリングに対応します。

注： PatentsView のサポートは 2026 年 5 月に終了しました。PatentsView がライブ API の代替を提供せず、バルクダウンロード用データセットのみを扱う USPTO ODP に移行したため、API ホスト search.patentsview.org は 2026-03-20 に廃止されました。米国特許の全文検索は Google BigQuery で、書誌データは USPTO ODP で利用できるようになりました。選択肢の分析については、docs/MCP_PLAN-PatentsView-Rehoming_2026-05-30.md を参照してください。

データソース

ソース	ツール	主な機能
USPTO ODP	30	出願、文書 PDF のダウンロード、PTAB、引用、訴訟、オフィスアクション
EPO OPS	8	INPADOC 特許ファミリー、約 44 の庁における法的ステータス、請求項／説明
Google BigQuery	4	9,000 万件以上の特許の全文検索、引用ネットワーク、CPC 分析

必要な API キーが設定されている場合に限り、ツールが登録されます。MCP クライアントに利用できないツールが表示されることはありません。

クイックスタート

pnpm install
cp .env.example .env    # Add your API keys
pnpm build

stdio で実行（Claude Desktop / Claude Code）

node dist/index.js

HTTP で実行（リモートデプロイ）

TRANSPORT=httpStream PORT=8080 node dist/index.js

MCP 設定（.mcp.json）

{
  "mcpServers": {
    "patents": {
      "command": "node",
      "args": ["dist/index.js"],
      "env": {
        "USPTO_API_KEY": "${USPTO_API_KEY}",
        "EPO_CONSUMER_KEY": "${EPO_CONSUMER_KEY}",
        "EPO_CONSUMER_SECRET": "${EPO_CONSUMER_SECRET}",
        "GOOGLE_APPLICATION_CREDENTIALS": "${GOOGLE_APPLICATION_CREDENTIALS}",
        "GOOGLE_CLOUD_PROJECT": "${GOOGLE_CLOUD_PROJECT}"
      }
    }
  }
}

MCP Inspector でテスト

npx @modelcontextprotocol/inspector node dist/index.js

設定

API キー

ソース	環境変数	入手先
USPTO ODP	USPTO_API_KEY	data.uspto.gov → MyODP
EPO OPS	EPO_CONSUMER_KEY + EPO_CONSUMER_SECRET	developers.epo.org
BigQuery	GOOGLE_APPLICATION_CREDENTIALS + GOOGLE_CLOUD_PROJECT	GCP Console（BigQuery のロールを持つサービスアカウント）

API キーが不足している場合、関連するツールは適切に無効化されます。サーバーは設定済みのソースを使って起動します。利用可能なソースを確認するには、check-api-status ツールを使用してください。

envpkt による認証情報の管理

このプロジェクトでは、認証情報の管理に envpkt を使用します。API キーはシール済み（age 暗号化済み）パケットとして保存され、シークレットではない設定は envpkt.toml の [env.*] エントリとして保存されます。.mcp.json は ${VAR} 構文で環境変数を参照し、これらの変数はシェルプロファイルで eval "$(envpkt env export)" を実行して読み込まれます。

パスの展開

GOOGLE_APPLICATION_CREDENTIALS は、functype-os を使ったチルダ（~）および環境変数（$HOME、${HOME}）の展開に対応しています。絶対パスの代わりに ~/.config/gcloud/key.json のようなパスを使用してください。

BigQuery のコストに関する注意

• 無料枠：スキャンされるクエリは月 1 TB
• 9,000 万件の特許を対象とする広範な全文検索では、クエリごとに約 200～300 GB がスキャンされます
• 特許番号、ファミリー、日付範囲を指定した CPC などの対象を絞ったクエリでは、スキャン量が大幅に少なくなります
• すべてのクエリは最初にドライランを実行し、推定コストが応答に含まれます

ツール

USPTO ODP（13 個のツール）

公式 USPTO Open Data Portal — 出願、審査経過、権利譲渡、文書。

• odp-search-applications — 特許出願を検索（2001 年以降）
• odp-get-application / metadata / continuity / assignment / adjustment / attorney / foreign-priority / transactions / documents
• odp-download-document — ファイルラッパーの文書を PDF としてダウンロードします（サーバーのキーを使って認証済みの取得を中継します）
• odp-search-datasets / get-dataset — バルクデータ製品

PTAB（7 個のツール）

付与後手続き — IPR、PGR、CBM、査定系審判。

• ptab-search-proceedings / get-proceeding / get-documents
• ptab-search-decisions / get-decision
• ptab-search-appeals / get-appeal

引用・訴訟（6 個のツール）

特許の引用および訴訟データ。

• citations-get-enriched / search / get-metrics
• litigation-search / get-case / get-patent

EPO OPS（8 個のツール）

欧州特許庁 — 国際的な対象範囲、INPADOC ファミリー、法的ステータス。

• epo-search-patents — CQL 検索（タイトル、要約、出願人、発明者、CPC、日付）
• epo-get-biblio / abstract / claims / description — 特許文書の各セクション
• epo-family-lookup — すべての管轄区域における INPADOC ファミリーの構成員
• epo-legal-status — 約44の特許庁における法的ステータス
• epo-number-convert — 番号形式の相互変換

Google BigQuery（4 個のツール）

9,000万件以上の特許文書を対象とした全文検索。クレーム検索では PPUBS に代わります。

• bigquery-patent-search — タイトルと要約を対象とした全文検索
• bigquery-patent-family — INPADOC ファミリー ID によるファミリー構成員の検索
• bigquery-citation-network — 引用グラフ（深さ1または2）
• bigquery-cpc-analytics — CPC 分類別の出願統計

オフィスアクション（4 個のツール）

USPTO のオフィスアクションデータ（2026年に ODP へ移行予定）。

• office-action-get-text / search / get-citations / get-rejections

ユーティリティ（3 個のツール）

• check-api-status — 設定済みのすべての API のヘルスチェック
• get-cpc-info — CPC 分類の検索
• get-status-code — USPTO ステータスコードの意味

プロンプト

一般的な特許分析タスク向けの、6つのワークフロープロンプトテンプレートです。

プロンプト	目的
prior_art_search	複数の情報源を使った先行技術調査ワークフロー
patent_validity	構造化された有効性分析（102/103/112）
competitor_portfolio	競合他社の特許ポートフォリオ分析
ptab_research	PTAB 手続きの調査（IPR/PGR/CBM）
freedom_to_operate	FTO 分析の手法
patent_landscape	技術分野のランドスケープマッピング

リソース

URI	説明
patents://cpc/{code}	CPC 分類情報
patents://status-codes	USPTO ステータスコードの定義
patents://sources	データソースの概要
patents://search-syntax	クエリ構文ガイド（EPO CQL、ODP、BigQuery）

開発

pnpm validate        # Format + lint + typecheck + test + build
pnpm test            # Run tests
pnpm build           # Production build
pnpm typecheck       # Type check only
pnpm codegen         # Regenerate Zod schemas from OpenAPI specs
pnpm fetch-specs     # Re-download OpenAPI specs from upstream

OpenAPI コード生成

レスポンススキーマは、Zod プラグインを使用した Hey API により、上流の OpenAPI 仕様から生成されます。

pnpm fetch-specs     # Download USPTO ODP spec
pnpm codegen         # Generate src/generated/odp/zod.gen.ts

生成されたコードはリポジトリにコミットされるため、CI でコード生成の手順を実行する必要はありません。

テスト

認証情報が利用可能な場合、統合テストは稼働中の API に対して実行されます。

# Requires USPTO_API_KEY in env
pnpm test

API キーがない場合、テストは問題なくスキップされます。

アーキテクチャ

FastMCP + Zod + ts-builds + functype-os で構築されています。

src/
├── index.ts                    # Entry point
├── server.ts                   # FastMCP instance
├── tools/                      # 45 tools across 7 modules (conditional registration)
├── clients/                    # API clients (base, ODP, EPO, BigQuery)
├── generated/                  # Zod schemas from OpenAPI specs (Hey API codegen)
├── specs/                      # Local copies of OpenAPI specs
├── resources/                  # 4 MCP resources
├── prompts/                    # 6 prompt templates
└── lib/                        # Config, retry, errors, patent number normalization

ライセンス

MIT

謝辞

• USPTO - 米国特許商標庁
• EPO OPS - 欧州特許庁オープン特許サービス
• Google Patents Public Data - BigQuery 特許データセット

---

SapientsAI の提供によるスポンサーシップ — ビジネス向けのエージェント型 AI を開発