Skip to main content
Glama

Google Patents MCP サーバー ( google-patents-mcp )

npmバージョン

このプロジェクトは、SerpApi Google Patents APIを介して Google Patents 情報を検索できる Model Context Protocol (MCP) サーバーを提供します。

変更履歴

v0.2.0 (2025-04-17)

  • 修正: resources/listおよびprompts/list MCP メソッドに空のハンドラーを実装しました。

  • **修正:**サーバーの初期化時にprompts機能を宣言しました。

  • **Chore:**依存関係を更新しました。

これらの変更は、これらの標準エンドポイントを必要とする可能性のある Claude Desktop などの MCP クライアントとの互換性を向上させることを目的としていますが、Claude Desktop での直接テストはまだ実行されていません。

Related MCP server: MCP Server for Google Search

特徴

  • Google Patents を検索するための MCP ツールsearch_patentsを提供します。

  • バックエンドとして SerpApi を使用します。

  • ローカルにインストールせずにnpxを使用して直接実行できます。

前提条件

  • **Node.js:**バージョン 18 以上を推奨します。

  • npm: npxコマンドを実行するために必要です。

  • SerpApi API キー: Google Patents API を使用するには、 SerpApiからの有効な API キーが必要です。

クイックスタート(npx を使用)

このサーバーを実行する最も簡単な方法は、 npxを使用することです。このコマンドは、(必要に応じて)サーバーをダウンロードし、直接実行します。

npx @kunihiros/google-patents-mcp

**注:**異なる場合は@kunihiros/google-patents-mcp実際の公開パッケージ名に置き換えてください。

サーバーが起動し、標準入出力で MCP 要求をリッスンします。

構成

サーバーはSerpApi APIキーを必要とします。以下のいずれかの方法で提供できます。

  1. **環境変数(MCP ホストに推奨):**サーバー実行時にSERPAPI_API_KEY環境変数を設定します。MCP ホスト構成では、多くの場合、サーバーの環境変数を設定できます。

    MCP ホスト構成スニペットの例 ( config.jsonまたは類似のもの):

    { "mcpServers": { "google-patents-mcp": { "command": "npx", "args": [ "-y", // Skips confirmation if the package isn't installed locally "@kunihiros/google-patents-mcp" // Use the correct package name ], "env": { "SERPAPI_API_KEY": "YOUR_ACTUAL_SERPAPI_KEY" // Optional: Set log level // "LOG_LEVEL": "debug" } } } }
  2. .env ファイル: npxコマンドを実行するディレクトリ (ローカルテストの場合、または MCP ホストを使用していない場合)、またはホームディレクトリ ( ~/.google-patents-mcp.env ) に、次の内容の.envファイルを作成します。

    SERPAPI_API_KEY=YOUR_ACTUAL_SERPAPI_KEY # Optional: Set log level (e.g., debug, info, warn, error) # LOG_LEVEL=debug

    注: .envファイルの使用はローカルテストには便利ですが、本番環境やMCPホストとの統合では、ホスト設定を介して環境変数を直接設定することが推奨され、より安全な方法です。主な使用例はnpx経由の実行であり、この場合、環境変数は通常、呼び出し元プロセスまたはMCPホストによって管理されます。

サーバーは、次の順序で.envファイルを検索します: * ./.env ( npxが実行される場所からの相対パス) * ~/.google-patents-mcp.env (ホーム ディレクトリ内)

提供されたMCPツール

search_patents

SerpApi 経由で Google 特許を検索します。

入力スキーマ:

{ "type": "object", "properties": { "q": { "type": "string", "description": "Search query (required). Although optional in SerpApi docs, a non-empty query is practically needed. Use semicolon (;) to separate multiple terms. Advanced syntax like '(Coffee) OR (Tea);(A47J)' is supported. See 'About Google Patents' for details." }, "page": { "type": "integer", "description": "Page number for pagination (default: 1).", "default": 1 }, "num": { "type": "integer", "description": "Number of results per page (default: 10). **IMPORTANT: Must be 10 or greater (up to 100).**", "default": 10, "minimum": 10, "maximum": 100 }, "sort": { "type": "string", "enum": ["relevance", "new", "old"], "description": "Sorting method. 'relevance' (default), 'new' (newest by filing/publication date), 'old' (oldest by filing/publication date).", "default": "relevance" }, "before": { "type": "string", "description": "Maximum date filter (e.g., 'publication:20231231', 'filing:20220101'). Format: type:YYYYMMDD where type is 'priority', 'filing', or 'publication'." }, "after": { "type": "string", "description": "Minimum date filter (e.g., 'publication:20230101', 'filing:20220601'). Format: type:YYYYMMDD where type is 'priority', 'filing', or 'publication'." }, "inventor": { "type": "string", "description": "Filter by inventor names. Separate multiple names with a comma (,)." }, "assignee": { "type": "string", "description": "Filter by assignee names. Separate multiple names with a comma (,)." }, "country": { "type": "string", "description": "Filter by country codes (e.g., 'US', 'WO,JP'). Separate multiple codes with a comma (,)." }, "language": { "type": "string", "description": "Filter by language (e.g., 'ENGLISH', 'JAPANESE,GERMAN'). Separate multiple languages with a comma (,). Supported: ENGLISH, GERMAN, CHINESE, FRENCH, SPANISH, ARABIC, JAPANESE, KOREAN, PORTUGUESE, RUSSIAN, ITALIAN, DUTCH, SWEDISH, FINNISH, NORWEGIAN, DANISH." }, "status": { "type": "string", "enum": ["GRANT", "APPLICATION"], "description": "Filter by patent status: 'GRANT' or 'APPLICATION'." }, "type": { "type": "string", "enum": ["PATENT", "DESIGN"], "description": "Filter by patent type: 'PATENT' or 'DESIGN'." }, "scholar": { "type": "boolean", "description": "Include Google Scholar results (default: false).", "default": false } }, "required": ["q"] }

出力:

SerpApiからの検索結果を含むJSONオブジェクトを返します。構造はSerpApiのレスポンス形式に従います。

使用例(MCPリクエスト):

{ "mcp_version": "1.0", "type": "CallToolRequest", "id": "req-123", "server_name": "google-patents-mcp", "params": { "name": "search_patents", "arguments": { "q": "organic light emitting diode", "num": 10, "language": "ENGLISH", "status": "GRANT", "after": "publication:20230101" } } }

発達

  1. リポジトリをクローンします (開発に必要な場合)。

    # git clone <repository-url> # cd google-patents-mcp
  2. 依存関係をインストールします:

    npm install
  3. .env.env.example.envにコピーし、 SERPAPI_API_KEYを追加します。

  4. 建てる:

    npm run build
  5. ローカルで実行:

    npm start

    または、自動再構築を使用した開発の場合:

    npm run dev

ログ記録

  • ログは標準エラーに出力されます。

  • ログレベルはLOG_LEVEL環境変数で制御できます( errorwarninfohttpverbosedebugsilly )。デフォルトはinfoです。

  • ログ ファイルは、プロジェクト ルート ( google-patents-server.log )、ユーザーのホーム ディレクトリ ( ~/.google-patents-server.log )、または/tmp/google-patents-server.logに作成されます。

ライセンス

MITライセンス(LICENSEファイルを参照)

One-click Deploy
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/KunihiroS/google-patents-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server