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:
- Erstellen Sie den TypeScript-Code:
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üsselGOOGLE_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:
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
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)
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)
- 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:
- 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