Google Patents MCP-Server ( google-patents-mcp )

Dieses Projekt bietet einen Model Context Protocol (MCP)-Server, der die Suche nach Google Patents-Informationen über die SerpApi Google Patents API ermöglicht.

Installation über Smithery

So installieren Sie den Google Patents MCP Server für Claude Desktop automatisch über Smithery :

npx -y @smithery/cli install @KunihiroS/google-patents-mcp --client claude

Änderungsprotokoll

v0.2.0 (17.04.2025)

• Fix: Leere Handler für die MCP-Methoden resources/list und prompts/list implementiert.

• Fix: Deklarierte prompts bei der Serverinitialisierung.

• Aufgabe: Abhängigkeiten aktualisiert.

Diese Änderungen zielen darauf ab, die Kompatibilität mit MCP-Clients wie Claude Desktop zu verbessern, die diese Standardendpunkte möglicherweise benötigen, obwohl noch keine direkten Tests mit Claude Desktop durchgeführt wurden.

Related MCP server: Serper MCP Server

Merkmale

• Bietet ein MCP-Tool search_patents zum Durchsuchen von Google Patents.

• Verwendet SerpApi als Backend.

• Kann ohne lokale Installation direkt mit npx ausgeführt werden.

Voraussetzungen

• Node.js: Version 18 oder höher wird empfohlen.

• npm: Erforderlich, um den npx -Befehl auszuführen.

• SerpApi-API-Schlüssel: Sie benötigen einen gültigen API-Schlüssel von SerpApi , um die Google Patents API zu verwenden.

Schnellstart (mit npx)

Am einfachsten lässt sich dieser Server mit npx ausführen. Dieser Befehl lädt den Server (falls erforderlich) herunter und führt ihn direkt aus.

npx @kunihiros/google-patents-mcp

Hinweis: Ersetzen Sie @kunihiros/google-patents-mcp durch den tatsächlich veröffentlichten Paketnamen, falls dieser abweicht.

Der Server wird gestartet und wartet auf MCP-Anfragen auf der Standardeingabe/-ausgabe.

Konfiguration

Der Server benötigt Ihren SerpApi-API-Schlüssel. Sie können ihn auf eine der folgenden Arten bereitstellen:

1. Umgebungsvariable (empfohlen für MCP-Hosts): Setzen Sie die Umgebungsvariable SERPAPI_API_KEY beim Ausführen des Servers. MCP-Hostkonfigurationen ermöglichen häufig das Setzen von Umgebungsvariablen für Server.

   Beispiel für einen MCP-Host-Konfigurationsausschnitt ( config.json oder ähnlich):

   {
     "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-Datei: Erstellen Sie eine .env Datei in dem Verzeichnis, in dem Sie den npx Befehl ausführen (für lokale Tests oder wenn Sie keinen MCP-Host verwenden), oder in Ihrem Home-Verzeichnis ( ~/.google-patents-mcp.env ), mit dem folgenden Inhalt:

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

   Hinweis: Die Verwendung einer .env Datei ist zwar für lokale Tests praktisch, für die Produktion oder die Integration mit MCP-Hosts ist jedoch das direkte Setzen der Umgebungsvariablen über die Hostkonfiguration der empfohlene und sicherere Ansatz. Der primäre Anwendungsfall ist die Ausführung über npx , wobei Umgebungsvariablen typischerweise vom aufrufenden Prozess oder MCP-Host verwaltet werden.

Der Server sucht in der folgenden Reihenfolge nach .env Dateien: * ./.env (relativ zum Ausführungsort von npx ) * ~/.google-patents-mcp.env (in Ihrem Home-Verzeichnis)

Mitgeliefertes MCP-Tool

search_patents

Durchsucht Google Patents über SerpApi.

Eingabeschema:

{
  "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"]
}

Ausgabe:

Gibt ein JSON-Objekt mit den Suchergebnissen von SerpApi zurück. Die Struktur folgt dem SerpApi-Antwortformat.

Beispielverwendung (MCP-Anforderung):

{
  "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"
    }
  }
}

Entwicklung

1. Klonen Sie das Repository (falls für die Entwicklung erforderlich):

   # git clone <repository-url>
   # cd google-patents-mcp

2. Installieren Sie Abhängigkeiten:

   npm install

3. Erstellen Sie .env Datei: Kopieren Sie .env.example nach .env und fügen Sie Ihren SERPAPI_API_KEY hinzu.

4. Bauen:

   npm run build

5. Lokal ausführen:

   npm start

   Oder für die Entwicklung mit automatischem Rebuild:

   npm run dev

Protokollierung

• Protokolle werden als Standardfehler ausgegeben.

• Die Protokollebene kann über die Umgebungsvariable LOG_LEVEL gesteuert werden ( error , warn , info , http , verbose , debug , silly ). Der Standardwert ist info .

• Es wird versucht, eine Protokolldatei im Projektstammverzeichnis ( google-patents-server.log ), im Home-Verzeichnis des Benutzers ( ~/.google-patents-server.log ) oder /tmp/google-patents-server.log zu erstellen.

Lizenz

MIT-Lizenz (siehe LICENSE-Datei)