Patent Mcp Server

Patent MCP Server

🚀 中国特許に最も正確なオープンソース MCP。 AI エージェントが高い精度で中国特許を読めるようにします。グローバルな特許データにも対応しています。

AI エージェントが特許データにアクセスできるようにする MCP（Model Context Protocol）サーバーです。CPC 分類を考慮した補正機能を備えた中国特許に加え、米国および WO の特許も対象としています。お使いのマシン上でローカルに動作します。外部 API もサブスクリプションも不要です。常に MIT ライセンスです。

---

セルフデプロイする理由

• Python だけで使えます。 インストールするだけで、エージェントから利用できます。管理するサーバーも共有する認証情報も必要ありません。
• 80％のユースケースでは API キーが不要です。 特許の詳細と請求項は、Google Patents の公開ページから直接取得します。
• データはローカルに保たれます。 マシンから外部に送信されるのは、ブラウザーが行うものと同じ HTTP リクエストだけです。
• BigQuery 検索は任意です。 14 億件のレコードを横断する全文検索が必要な場合にのみ有効にしてください。

---

30 秒でインストール

pip install deeparchi-patent-mcp

または、ソースからインストールします。

git clone https://github.com/deeparchi-ai/patent-mcp-server.git
cd patent-mcp-server
pip install -e .

---

クイックスタート

pip install の実行後、deeparchi-patent-mcp コンソールスクリプトが PATH 上で利用できるようになります。 エージェントプラットフォームの MCP 設定に以下を追加します。

Claude Desktop

{
  "mcpServers": {
    "patent-mcp": {
      "command": "deeparchi-patent-mcp",
      "args": []
    }
  }
}

Cursor / Windsurf / Cline

上記の Claude Desktop と同じ設定を使用します。

Hermes Agent

mcp_servers:
  patent-mcp:
    command: "deeparchi-patent-mcp"

BigQuery は任意です。 GCP_PROJECT_ID を設定しなくてもサーバーは通常どおり起動し、 ウェブ経由のツールは認証情報なしで動作します。BigQuery を使用するツールは、 有効化方法を説明するメッセージを返します。有効にするには、環境変数を追加します。

{
  "mcpServers": {
    "patent-mcp": {
      "command": "deeparchi-patent-mcp",
      "args": [],
      "env": { "GCP_PROJECT_ID": "your-gcp-project" }
    }
  }
}

ソースチェックアウトから実行する

{
  "mcpServers": {
    "patent-mcp": {
      "command": "python",
      "args": ["-m", "server"],
      "cwd": "/path/to/patent-mcp-server/src"
    }
  }
}

---

エージェントに次のように尋ねてみてください。

「特許 US-7650331-B1 を取得して、請求項を要約してください。」

---

含まれる機能

ツール	機能	セットアップが必要？
get_patent	特許の詳細情報：分類、引用（X/Y/A/D）、発明者、譲受人、ファミリー	いいえ
get_patent_claims	特許の請求項テキスト（法的な権利範囲）。Google Patents 経由で米国、中国、およびほとんどの国に対応	いいえ
search_patents	キーワード、CPC、譲受人、国、日付範囲で14億件の特許を検索	任意の GCP 設定

最初の2つで、80％のユースケースをカバーできます。費用はかからず、セットアップも不要です。

中国特許検索（v1.7.0）

中国特許を3層で検索します。

レイヤー	バックエンド	費用	使用条件
1. BigQuery	Google Patents Public Data	無料枠	cpc=H01L + country=CN
2. Firecrawl	ウェブ検索へのフォールバック	1クエリあたり4クレジット	BigQuery が特定の CPC（例：H01L25/065）をコスト上の理由で拒否した場合
3. Google Patents	プロキシ経由で詳細情報を補完	無料	すべての特許詳細の検索

• キーワード検索に対応： query="芯片" + country=CN で、英語と中国語の両方の要約を検索します（v1.5.2 の修正）。
• 譲受人フィルター： assignee="BOE" + country=CN → 企業・都市レベルの特許動向を把握できます。
• CPC 分類： 中国特許を幅広く検索するには上位の CPC クラス（H01L）を使用してください。具体的な CPC コード（H01L25/065）を指定すると、ウェブ検索にフォールバックします。
• 詳細な検索方法とテスト済み CPC コードについては、SEARCH_GUIDE.md を参照してください。

---

任意：BigQuery 検索を有効にする

search_patents が必要な場合は、GCP プロジェクトを追加します。

1. BigQuery を有効にした GCP プロジェクトを作成します
2. サービスアカウントを作成し、JSON キーをダウンロードします
3. 環境変数を設定します。

   export GOOGLE_APPLICATION_CREDENTIALS="/path/to/key.json"
   export GCP_PROJECT_ID="your-project-id"
   

4. ラッパーのテンプレートをコピーし、パスを設定します。

   cp run.sh.example run.sh
   # Edit run.sh → set your GCP paths
   

BigQuery の無料枠は月1 TBです。個人利用なら実質無料です。

---

高度な設定：チームサーバー（HTTP/SSE）

複数のメンバーで1つの patent-mcp インスタンスを共有する必要がありますか？HTTP サーバーとして起動します。

cp run-http.sh.example run-http.sh
# Edit → set GCP creds (skip if only using web tools)
PORT=8090 ./run-http.sh

チームメンバーは次の方法で接続します。

mcp_servers:
  patent-mcp:
    url: "http://<server-ip>:8090/sse"

本番環境へのデプロイ用に、systemd サービステンプレートが含まれています。

---

仕組み

┌──────────────┐     ┌───────────────────────────────────────┐
│  AI Agent    │────▶│  patent-mcp-server                    │
│  (Claude,    │     │  (runs on YOUR machine)               │
│   Cursor,    │     │                                       │
│   Hermes)    │     │  search_patents:                      │
│              │     │    ┌──────────┐    ┌───────────────┐  │
│              │     │    │ BigQuery │───▶│ Firecrawl     │  │
│              │     │    │ (primary)│    │ (CN fallback) │  │
│              │     │    └──────────┘    └───────┬───────┘  │
│              │     │                           │           │
│              │     │  get_patent / get_patent_claims:      │
│              │     │    ┌──────────────────────┐           │
│              │     │    │ Google Patents (web) │           │
│              │     │    │ → BigQuery fallback  │           │
│              │     │    └──────────────────────┘           │
└──────────────┘     └───────────────────────────────────────┘

• 詳細情報のウェブスクレイピング — 高速（約1.5秒）、無料、認証情報不要
• 検索には BigQuery — 14億件のレコード、中国語全文検索、任意
• 中国語検索のフォールバックには Firecrawl — BigQuery が特定の CPC クエリをコスト上の理由で拒否した場合に実行されます
• スマートなフォールバック — すべてのツールはまずウェブを検索し、利用可能な場合は自動的に BigQuery にフォールバックします

---

ツールリファレンス

get_patent

get_patent(publication_number="US-7650331-B1")

返される情報：分類、引用（X/Y/A/D の先行技術マーカー）、ファミリー ID、日付、発明者、譲受人。先行技術マーカーを引用するため、エージェントは新規性を一目で評価できます。

中国特許に関する注意： Google Patents のウェブスクレイピングでは、中国特許のデータは機械翻訳された英語で取得されます。ウェブスクレイピングでは CPC コードを取得できません（JavaScript でレンダリングされるため）。CPC コードを取得するには、BigQuery 経由の方法を使用してください。

get_patent_claims

get_patent_claims(publication_number="US-7650331-B1")

返される情報：請求項の全文。Google Patents のウェブスクレイピングを通じて、米国、中国（機械翻訳された英語）、およびほとんどの国に対応しています。

search_patents

search_patents(cpc="G06N", country="CN", after="2023-01-01", limit=5)
search_patents(assignee="TSMC", country="CN")
search_patents(query="芯片", country="CN")          # keyword search (CN: searches both EN+ZH)

キーワード、CPC 分類、譲受人、国、日付範囲を指定して、14億件の特許を検索します。中国特許では、キーワード検索で英語と中国語の両方の要約が対象になります。

コスト管理： クエリには少なくとも1つのフィルター（cpc／country／assignee／after）が必要です。ドライランによる予算ガードが、50 GB を超えるクエリを拒否します。BigQuery が中国特許の CPC クエリ（例：H01L25/065 → 256 GB）を拒否すると、ウェブ検索へのフォールバックにより Firecrawl 経由で自動検索します。

ベストプラクティスについてはSEARCH_GUIDE.md、テスト済みの CPC コードについてはdocs/cn-cpc-correction-table.mdを参照してください。

---

開発

pip install -e ".[dev]"

pytest tests/ -v          # 32 tests, ~1.5s
ruff check src/ tests/    # lint
mypy src/                 # type check

---

ライセンス

MIT — LICENSEを参照してください。

---

作者

DeepArchi OPC — エンタープライズアーキテクチャ向け AI エージェントインフラストラクチャ。