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:

1. Besuchen Sie die SERP API-Website und erstellen Sie ein Konto

2. 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

3. 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.

4. 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

1. Installieren Sie Abhängigkeiten:

npm install

2. Erstellen Sie den Server:

npm run build

3. 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"
      }
    }

4. Starten Sie den Server:

npm start

Fehlerbehebung

1. 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

2. Anforderungsfehler

• Überprüfen der Netzwerkkonnektivität

• Überprüfen Sie, ob das API-Aufrufkontingent überschritten wurde

• Überprüfen des Anforderungsparameterformats

Related MCP server: MCP Google Server

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 .