patent-mcp
This server provides patent information retrieval and analysis tools for AI agents. It includes:
search_patents: Search patents by keywords, assignee, inventor, date ranges, country, and status, with support for pagination, Boolean operators, and output in markdown or JSON.
find_similar_patents: Find patents similar to an existing patent (by publication number) or a free-text idea. Multiple strategies are available (auto, provider_similar, semantic, classification) with filters for date, country, and family exclusion.
get_patent: Retrieve detailed patent information (bibliographic data, abstract, claims, description, classifications, citations, family) by publication number, with section selection and output format options.
list_patent_providers: List available data sources (e.g., Google Patents, EPO OPS) and their capabilities.
Key features include a pluggable data source architecture with per-call provider switching, configurable via environment variables (default provider, language, timeouts), robust handling of HTML-based providers with automatic validation and fallback, and built-in rate limiting and retry mechanisms.
Provides patent search and retrieval from Google Patents, including keyword/assignee/inventor/date searches, similar patent discovery, and fetching patent summaries, claims, descriptions, classifications, citations, and family information.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@patent-mcp Search for solid-state battery patents by Toyota from 2020 onward"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
patent-mcp
特許情報を取得して Agent にコンテキストとして渡すための、ローカル実行の MCP サーバー。
データソースはインターフェースの背後に隠してあるので、あとから
Google Patents → 特許庁 API → EPO OPS のように差し替え・追加ができる。
ツールも tools/ にファイルを置くだけで増える。
ツール
ツール | 用途 |
| キーワード・出願人・発明者・期間で特許を検索する |
| 既存特許や自由文(アイデア・請求項案)に似た特許を探す |
| 公開番号を指定して要約・請求項・明細書・分類・引用・ファミリーを取得する |
| 利用可能なデータソースと対応機能を確認する |
Related MCP server: patents-mcp
セットアップ
uv sync動作確認:
uv run patent-mcp --helpエディタ / エージェントへの登録
以下、リポジトリの絶対パスを /path/to/patent-mcp と表記する(pwd で確認できる)。
uv のフルパスは which uv で確認する(通常 ~/.local/bin/uv)。
Claude Code
claude mcp add patent -- uv --directory /path/to/patent-mcp run patent-mcpClaude Desktop
claude_desktop_config.json に追加:
{
"mcpServers": {
"patent": {
"command": "uv",
"args": ["--directory", "/path/to/patent-mcp", "run", "patent-mcp"],
"env": { "PATENT_MCP_LANG": "ja" }
}
}
}GitHub Copilot(VS Code)
VS Code の Copilot Chat(Agent モード)は MCP サーバーに対応している。
ワークスペース直下に .vscode/mcp.json を作る(チーム共有したくない場合は
.vscode/mcp.json を .gitignore に入れるか、ユーザー設定側の MCP 設定に書く)。
{
"servers": {
"patent": {
"type": "stdio",
"command": "uv",
"args": ["--directory", "/path/to/patent-mcp", "run", "patent-mcp"],
"env": { "PATENT_MCP_LANG": "ja" }
}
}
}有効化手順:
VS Code でこのリポジトリ(または
.vscode/mcp.jsonを置いたワークスペース)を開くコマンドパレットで
MCP: List Serversを実行し、patentが認識されているか確認(表示されない場合はMCP: Add Serverから同じ内容を登録する)Copilot Chat を Agent モードにする(チャット入力欄のモード切り替え)
ツール一覧(レンチ/ツールアイコン)に
search_patentsなどが並んでいることを確認して使う
ユーザー全体で使い回したい場合は、ワークスペースではなくコマンドパレットの
MCP: Open User Configuration から同じ内容をユーザー設定側に書いてもよい。
VS Code の MCP サポートは変更が速いので、上記でうまくいかない場合は
VS Code 側の最新ドキュメント(Copilot Chat の MCP servers)を確認すること。
設定(環境変数)
変数 | 既定値 | 説明 |
|
| 使用するデータソース |
|
| 本文の言語 |
|
| HTTP タイムアウト(秒) |
|
| 1回の検索で返す上限 |
|
| 1セクションの最大文字数 |
プロバイダ固有の設定は PATENT_MCP_<プロバイダ名>_<キー> で渡す。
例: PATENT_MCP_EPO_OPS_KEY=xxx → settings.options_for("epo_ops") == {"key": "xxx"}
google_patents プロバイダ固有:
変数 | 既定値 | 説明 |
|
| リクエスト間の最小間隔(秒) |
|
| 429/503 を受けたときの再試行回数 |
Google Patents は短時間に連続アクセスすると 503 を返す。
まとめて多数の特許を調べる用途では MIN_INTERVAL を 2〜3 秒に上げるとよい。
使用例(Agent 側の会話)
「全固体電池の界面抵抗低減について、2022年以降の日本の特許を10件調べて」
「JP2020123456A に似た特許を、優先日が2019年より前のものに限って探して」
「この請求項案に近い先行技術がないか調べて: 〈本文〉」
「US9634296B2 の請求項1と、引用されている文献を出して」
HTML構造の変更をどう検知するか
既定のプロバイダは Google Patents の HTML を読むので、Google が構造を変えると壊れる。 やっかいなのは例外を出さずに中身だけ欠ける壊れ方で、放っておくと Agent が 「請求項の無い特許」と誤解して結論を出す。3段構えで検知する。
1. 実行時の自動チェック(常に効く)
毎回の取得でパースの妥当性を自己点検し、怪しければ結果の冒頭に警告を出す。
どの特許にも必ずあるはずのもの(タイトル・要約・請求項・明細書)が空
セクションは存在するのに中身が抽出できない
ページが書いている請求項の件数と、抽出できた件数が食い違う
# JP2020123456A — 蓄電素子、蓄電素子の製造方法
> **取得できていない情報があります**
> - 請求項: ページには16項とあるのに2項しか抽出できていません。内容が欠けています。
>
> この結果だけで「存在しない」と判断せず、元ページを確認してください: ...引用やファミリーは本当に0件のことがあるので対象外。誤検知しない範囲に絞ってある。
2. ライブ契約テスト(触ったときに実行)
uv run python -m pytest -m network実ページに接続し、パーサが依存する11個のセレクタが今も存在するか確認する。
3. オフラインテスト(編集時の回帰防止)
HTML をわざと壊して、上記1の検知が働くことまでテストしている。
テスト
網羅は狙っていない。このプロジェクトのバグは実データで動かしたときにしか 見つからなかったので、テストは「一度やらかした罠の記録」と 「Google の HTML が変わったことの検知」に絞ってある。
uv run python -m pytest # オフライン20件
uv run python -m pytest -m network # ライブ契約テストファイル | 役割 |
| 実際に壊れたパースの再発防止(請求項の潰れ、二重エンコード等) |
| 「特開2020-123456」等の表記ゆれ吸収 |
| データソース差し替えの前提が壊れていないこと |
| 実ページに接続し、依存セレクタが今も存在するか確認 |
tests/fixtures/patent_page.html は実ページのダウンロードではなく、
構造だけを再現した手書きのファイル。実ページを置かないのは、
他社の著作物を取り込むことになるうえ、Google 自身のウィジェット用 API キーが
埋まっていてシークレットスキャナが誤検知するため。
手書きなので「パーサを編集して壊したか」は分かるが、
「そもそも Google の HTML を誤解していたか」は分からない。
そこは -m network のライブ契約テストが実物に当てて確認する。
セレクタを触ったときや、パース結果が変になったときに実行すること。
ライブ契約テストは既定でスキップされる(レート制限を避けるため)。 レート制限中も失敗ではなくスキップになるので、時間をおいて再実行する。
拡張する
データソースを足す
src/patent_mcp/providers/ にファイルを1つ作るだけ。
from . import register
from .base import Capability, PatentProvider, SearchQuery
from ..models import SearchResult
@register
class JpoProvider(PatentProvider):
name = "jpo"
description = "特許庁 特許情報取得API"
capabilities = frozenset({Capability.SEARCH, Capability.BIBLIOGRAPHIC})
requires_credentials = True
async def search(self, query: SearchQuery) -> SearchResult:
token = self.options["token"] # PATENT_MCP_JPO_TOKEN
...未実装のメソッドは基底クラスが NotSupportedError を投げ、ツールが
「このプロバイダは未対応」と Agent に伝える。登録リストの編集は不要
(providers/__init__.py がモジュールを自動検出する)。
PATENT_MCP_PROVIDER=jpo で既定を切り替えられるほか、
各ツールの provider 引数で呼び出しごとに切り替えられる。
ツールを足す
src/patent_mcp/tools/ にファイルを1つ作り、register を定義する。
def register(mcp, ctx):
@mcp.tool()
async def my_tool(...) -> str:
"""Agent 向けの説明。"""
provider = ctx.provider()
...注意
既定の google_patents プロバイダは Google Patents の公開ページを読む非公式実装で、
サイト構造の変更やレート制限の影響を受ける。業務で確実性が必要な場合は、
特許庁の特許情報取得API や EPO OPS のプロバイダを追加して切り替えること。
取得できるのは公開情報であり、権利範囲の解釈や侵害判断は専門家の確認が必要。
Available Tools
4 toolsfind_similar_patentsA
既存特許または自由文に似た特許を探す(先行技術調査・侵害調査向け)。
使い分け:
- 既存の特許を起点にする場合は publication_number を渡す
- 未出願のアイデアや請求項案から探す場合は text を渡す
- 両方渡すと、その特許の周辺をテキストの観点で絞り込む
結果の各件には「どの手法でヒットしたか」が付くので、
提供元の類似判定によるものか、意味検索によるものかを区別できる。
Inputs: text, after, limit, before, +7 more. Returns: result
get_patentA
公開番号を指定して特許の中身を取得する。
請求項の文言確認、明細書の読み込み、引用関係やファミリーの把握に使う。 必要なセクションだけを指定すると、コンテキストを無駄に消費しない。
Inputs: publication_number (required), language, provider, sections, +2 more. Returns: result
list_patent_providersA
利用できる特許データソースと、それぞれが対応している機能を返す。
ツールが「未対応」と答えたときや、別のデータソースに切り替えたいときに使う。
Inputs: no named parameters. Returns: result
search_patentsA
特許をキーワードで検索し、書誌情報と該当箇所の抜粋を返す。
技術テーマや出願人から先行技術の当たりをつけるのに使う。
個々の請求項や明細書が必要になったら get_patent を呼ぶこと。
Inputs: query (required), page, after, limit, +8 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a distinct purpose: provider metadata, direct retrieval by number, keyword search, and similarity search. Any potential overlap between search_patents and find_similar_patents is clearly resolved through descriptions of input types and use cases.
All tool names follow the consistent verb_noun pattern (list_, get_, search_, find_) with snake_case. The pattern is predictable and makes the tool set easy to navigate.
Four tools is an ideal size for this domain. Each tool is necessary and covers a core aspect of patent search and retrieval without redundancy or bloat.
The set covers the full workflow of patent discovery and examination: find providers, search, retrieve specific patents, and find similar ones. Minor gaps like legal status or batch export exist but are not critical for typical patent research tasks.
Related MCP Connectors
MCP server for building and testing AI agents with multi-model experimentation and insights.
MCP server connecting AI agents to 100+ apps (Gmail, Slack, Notion, GitHub) via one-click OAuth.
Web search API and MCP server for developers building AI agents.
An MCP memory server. One memory your agents share — across models, devices and apps.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceMCP server for USPTO patent prior-art search, enabling keyword search, ranking, and date filtering via Claude, Cursor, or Windsurf.-
- AlicenseAqualityCmaintenanceMCP server for patent search and prior art discovery powered by Google Patents public dataset on BigQuery. Supports searching patents, fetching full patent details with CPC codes and citations, and retrieving legal claims text.36MIT
- AlicenseNot gradedqualityBmaintenanceAn MCP server that enables patent creation and analysis, including regulation search, prior art discovery, claim compliance checks, and patent diagram generation, all within Claude Code.211MIT
- AlicenseAqualityBmaintenanceAn MCP server that gives AI agents access to global patent data, including 1.4 billion records and Chinese full-text, with zero-config mode for basic tools.1153 PyPI3MIT