Google Search MCP-Server

Version 2.0 ist da

Google Search MCP-Server

Ein MCP-Server (Model Context Protocol), der Google-Suchfunktionen und Tools zur Analyse von Webseiteninhalten bereitstellt. Dieser Server ermöglicht KI-Modellen die programmgesteuerte Durchführung von Google-Suchen und die Analyse von Webseiteninhalten.

Merkmale

Integration der benutzerdefinierten Google-Suche
Erweiterte Suchfunktionen (Filter, Sortierung, Paginierung, Kategorisierung)
Analyse des Webseiteninhalts in mehreren Formaten (Markdown, HTML, einfacher Text)
Batch-Webseitenanalyse
Ergebniskategorisierung und -klassifizierung
Inhaltszusammenfassung
Optimierte, für Menschen lesbare Antworten
MCP-kompatible Schnittstelle

Voraussetzungen

Node.js (v16 oder höher)
Google Cloud Platform-Konto
Benutzerdefinierte Suchmaschinen-ID
Google API-Schlüssel

Installation

Klonen Sie das Repository
Installieren Sie Node.js-Abhängigkeiten:

npm install

Erstellen Sie den TypeScript-Code:

npm run build

Konfiguration

Richten Sie Umgebungsvariablen für Ihre Google-API-Anmeldeinformationen ein:

Sie können diese entweder als Systemumgebungsvariablen festlegen oder in Ihrer MCP-Einstellungsdatei konfigurieren.

Erforderliche Umgebungsvariablen:

GOOGLE_API_KEY : Ihr Google API-Schlüssel
GOOGLE_SEARCH_ENGINE_ID : Ihre benutzerdefinierte Suchmaschinen-ID

Fügen Sie die Serverkonfiguration zu Ihrer MCP-Einstellungsdatei hinzu (normalerweise unter %APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json ):

{
  "mcpServers": {
    "google-search": {
      "autoApprove": [
        "google_search",
        "extract_webpage_content",
        "extract_multiple_webpages"
      ],
      "disabled": false,
      "timeout": 60,
      "command": "node",
      "args": [
        "/path/to/google-search-mcp-server/dist/google-search.js"
      ],
      "env": {
        "GOOGLE_API_KEY": "your-google-api-key",
        "GOOGLE_SEARCH_ENGINE_ID": "your-custom-search-engine-id"
      },
      "transportType": "stdio"
    }
  }
}

Läuft

Starten Sie den MCP-Server:

npm run start

Verfügbare Tools

1. Google-Suche

Durchsuchen Sie Google und erhalten Sie relevante Ergebnisse aus dem Web. Dieses Tool findet mithilfe der Google-Suchmaschine Webseiten, Artikel und Informationen zu bestimmten Themen.

{
  "name": "google_search",
  "arguments": {
    "query": "your search query",
    "num_results": 5, // optional, default: 5
    "site": "example.com", // optional, limit results to specific website
    "language": "en", // optional, filter by language (ISO 639-1 code)
    "dateRestrict": "m6", // optional, filter by date (e.g., "m6" for last 6 months)
    "exactTerms": "exact phrase", // optional, search for exact phrase
    "resultType": "news", // optional, specify type (news, images, videos)
    "page": 2, // optional, page number for pagination (starts at 1)
    "resultsPerPage": 10, // optional, results per page (max: 10)
    "sort": "date" // optional, sort by "date" or "relevance" (default)
  }
}

Die Antwort umfasst:

Suchergebnisse mit Titel, Link, Snippet in einem lesbaren Format
Seitennummerierungsinformationen (aktuelle Seite, Gesamtergebnisse usw.)
Ergebniskategorien (automatisch erkannt)
Navigationshinweise zur Paginierung

2. Webseiteninhalt extrahieren

Extrahieren und analysieren Sie Inhalte einer Webseite und konvertieren Sie sie in lesbaren Text. Dieses Tool ruft den Hauptinhalt ab und entfernt gleichzeitig Anzeigen, Navigationselemente und anderen Unrat.

{
  "name": "extract_webpage_content",
  "arguments": {
    "url": "https://example.com",
    "format": "markdown" // optional, format options: "markdown" (default), "html", or "text"
  }
}

Die Antwort umfasst:

Titel und Beschreibung der Webseite
Inhaltsstatistiken (Wortzahl, Zeichenanzahl)
Inhaltszusammenfassung
Inhaltsvorschau (erste 500 Zeichen)

3. mehrere Webseiten extrahieren

Extrahieren und analysieren Sie Inhalte mehrerer Webseiten mit einer einzigen Anfrage. Ideal zum Vergleichen von Informationen aus verschiedenen Quellen oder zum Sammeln umfassender Informationen zu einem Thema.

{
  "name": "extract_multiple_webpages",
  "arguments": {
    "urls": [
      "https://example1.com",
      "https://example2.com"
    ],
    "format": "html" // optional, format options: "markdown" (default), "html", or "text"
  }
}

Die Antwort umfasst:

Titel und Beschreibung jeder Webseite
Inhaltsstatistiken für jede Webseite
Inhaltszusammenfassung für jede Webseite
Inhaltsvorschau für jede Webseite (erste 150 Zeichen)

Abrufen der Google-API-Anmeldeinformationen

Gehen Sie zur Google Cloud Console
Erstellen Sie ein neues Projekt oder wählen Sie ein vorhandenes aus
Aktivieren der benutzerdefinierten Such-API
API-Anmeldeinformationen (API-Schlüssel) erstellen
Gehen Sie zur Seite „Benutzerdefinierte Suchmaschine“
Erstellen Sie eine neue Suchmaschine und erhalten Sie Ihre Suchmaschinen-ID
Fügen Sie diese Anmeldeinformationen zu Ihrer MCP-Einstellungsdatei hinzu oder legen Sie sie als Umgebungsvariablen fest

Fehlerbehandlung

Der Server liefert detaillierte Fehlermeldungen für:

Fehlende oder ungültige API-Anmeldeinformationen
Fehlgeschlagene Suchanfragen
Ungültige Webseiten-URLs
Probleme mit der Netzwerkkonnektivität

Architektur

Der Server basiert auf TypeScript und nutzt das MCP SDK, um eine standardisierte Schnittstelle für KI-Modelle bereitzustellen, die mit der Google-Suche und Tools zur Analyse von Webseiteninhalten interagieren. Er besteht aus zwei Hauptdiensten:

GoogleSearchService : Verarbeitet Google API-Interaktionen für die Suchfunktion
ContentExtractor : Verwaltet die Analyse und Extraktion von Webseiteninhalten

Der Server verwendet Caching-Mechanismen, um die Leistung zu verbessern und API-Aufrufe zu reduzieren.

Verteilen der erstellten Version

Wenn Sie lieber nur die erstellte Version dieses Tools und nicht den Quellcode verteilen möchten, können Sie die folgenden Schritte ausführen:

Erstellen Sie den TypeScript-Code:

npm run build

Erstellen Sie ein Distributionspaket mit nur den erforderlichen Dateien:

# Create a distribution directory
mkdir -p dist-package

# Copy the compiled JavaScript files
cp -r dist dist-package/

# Copy package files (without dev dependencies)
cp package.json dist-package/
cp README.md dist-package/

# Create a simplified package.json for distribution
node -e "const pkg = require('./package.json'); delete pkg.devDependencies; delete pkg.scripts.build; delete pkg.scripts.dev; pkg.scripts.start = 'node dist/google-search.js'; require('fs').writeFileSync('dist-package/package.json', JSON.stringify(pkg, null, 2));"

Benutzer können dann die erstellte Version installieren und ausführen:

# Install production dependencies only
npm install --production

# Start the server
npm start

Mit diesem Ansatz können Sie die kompilierten JavaScript-Dateien verteilen, ohne den TypeScript-Quellcode offenzulegen. Benutzer müssen weiterhin Folgendes tun:

Konfigurieren Sie ihre Google API-Anmeldeinformationen als Umgebungsvariablen
Fügen Sie die Serverkonfiguration zu ihrer MCP-Einstellungsdatei hinzu
Installieren Sie die Produktionsabhängigkeiten

Beachten Sie, dass die Datei package.json in der Distribution nur Produktionsabhängigkeiten und einen vereinfachten Satz von Skripts enthält.

Lizenz

MIT

Google Search MCP Server

Integrations

Version 2.0 ist da