Google News MCP-Server

Eine Serverimplementierung des Model Context Protocol (MCP), die über die SerpAPI-Integration Google News-Suchfunktionen bereitstellt. Automatische Kategorisierung der Nachrichtenergebnisse und Unterstützung mehrerer Sprachen und Regionen.

https://github.com/user-attachments/assets/1cc71c27-f840-4c94-9ab5-460d84ba4779

✨ Funktionen

🔍 Flexible Suchoptionen

Umfassende Suchfunktionen, einschließlich abfragebasierter Suche, Themensuche, Veröffentlichungsfilterung und Story-Berichterstattung.

🌐 Globale Abdeckung

Unterstützt mehrere Sprachen und Regionen durch konfigurierbare Sprach- und Ländercodes.

📊 Intelligente Kategorisierung

Kategorisiert Nachrichtenergebnisse automatisch in Themen wie KI und Technologie, Wirtschaft, Wissenschaft und Forschung sowie Gesundheitswesen.

🔀 Mehrere Ergebnistypen

Verarbeitet verschiedene Nachrichtenergebnistypen, darunter Schlagzeilen, Storys, verwandte Themen und Menülinks.

🛠️ Robuste Fehlerbehandlung

Umfassende Fehlerbehandlung bei API-Fehlern und ungültigen Eingaben mit hilfreichen Fehlermeldungen.

🌍 Sprachunterstützung

Automatischer Fallback auf Englisch bei nicht unterstützten Sprachcodes mit entsprechenden Benutzerbenachrichtigungen.

🔑 SERP-API-Setup-Anleitung

Bevor Sie beginnen, benötigen Sie einen SERP-API-Schlüssel. So geht's:

Besuchen Sie die SERP API-Website und erstellen Sie ein Konto
Gehen Sie nach der Registrierung zu Ihrem Dashboard:
- Suchen Sie den Abschnitt „API-Schlüssel“
- Kopieren Sie Ihren API-Schlüssel
- Neue Benutzer erhalten 100 kostenlose API-Aufrufe
Details zur API-Nutzung:
- Kostenlose Stufe: 100 Suchvorgänge pro Monat
- Bezahlte Pläne beginnen bei 50 $/Monat für 5000 Suchvorgänge
- Abrechnung basierend auf erfolgreichen API-Aufrufen
- Mehrere Zahlungsmethoden: Kreditkarte, PayPal usw.
Nutzungsbeschränkungen:
- Anforderungsrate: 2 Anfragen/Sekunde
- IP-Einschränkungen: Keine
- Gleichzeitige Anfragen: 5
- Antwort-Cache-Zeit: 1 Stunde

👩‍🔧 Lösung für Verbindungsprobleme von MCP-Servern mit NVM/NPM

Klicken Sie hier, um meine Konfigurationslösung anzuzeigen 👉 https://github.com/modelcontextprotocol/servers/issues/76

🚀 Schnellstart

Installieren Sie Abhängigkeiten:

npm install

Erstellen Sie den Server:

npm run build

Umgebung konfigurieren: Ändern Sie Ihre claude_desktop_config.json mit dem folgenden Inhalt (passen Sie die Pfade entsprechend Ihrem System an):

    "google-news": {
      "command": "D:\\Program\\nvm\\node.exe",
      "args": [
        "D:\\github_repository\\path_to\\dist\\index.js"
      ],
      "env": {
        "SERP_API_KEY": "your-api-key"
      }
    }

Starten Sie den Server:

npm start

Fehlerbehebung

Ungültiger API-Schlüssel

Überprüfen Sie die API-Schlüsselkonfiguration in claude_desktop_config.json
Bestätigen Sie, dass der API-Schlüssel im SERP-API-Dashboard aktiv ist

Anforderungsfehler

Überprüfen der Netzwerkkonnektivität
Überprüfen Sie, ob das API-Aufrufkontingent überschritten wurde
Überprüfen des Anforderungsparameterformats

Ausführen von Evaluierungen

Das Evals-Paket lädt einen MCP-Client, der anschließend die Datei index.ts ausführt, sodass zwischen den Tests kein Neuaufbau erforderlich ist. Sie können Umgebungsvariablen laden, indem Sie dem Befehl npx voranstellen. Die vollständige Dokumentation finden Sie hier .

OPENAI_API_KEY=your-key  npx mcp-eval src/evals/evals.ts src/index.ts

📦 Installation

Installation über Smithery

So installieren Sie Google News für Claude Desktop automatisch über Smithery :

npx -y @smithery/cli install @chanmeng666/google-news-server --client claude

Installation über mcp-get

npx @michaellatman/mcp-get@latest install @chanmeng666/google-news-server

Wenn Sie eine alte Version von Windows PowerShell verwenden, müssen Sie möglicherweise vor diesem Befehl Set-ExecutionPolicy Bypass -Scope Process ausführen.

Manuelle Installation

@chanmeng666/google-news-server

# Using npm
npm i @chanmeng666/google-news-server
# or
npm install @chanmeng666/google-news-server

# Using yarn
yarn add @chanmeng666/google-news-server

# Using pnpm
pnpm add @chanmeng666/google-news-server

💻 Tech-Stack

📖 API-Dokumentation

Der Server implementiert das Model Context Protocol und stellt ein Google News-Suchtool mit den folgenden Parametern bereit:

q : Suchabfragezeichenfolge
gl „us“, „uk“)
hl : Sprachcode (z. B. „en“, „es“)
topic_token : Token für bestimmte Nachrichtenthemen
publication_token : Token für bestimmte Herausgeber
story_token : Token für die vollständige Berichterstattung einer Story
section_token : Token für bestimmte Abschnitte

🔧 Entwicklung

# Run in development mode with hot reload
npm run dev

# Run linting
npm run lint

# Run tests
npm run test

📝 Lizenz

Dieses Projekt ist MIT-lizenziert .

🙋‍♀ Autor

Erstellt und gepflegt von Chan Meng .

Google News MCP Server

Integrations