Google News MCP Server

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Provides Google News search capabilities via SerpAPI integration, supporting flexible search options, global coverage, smart categorization of news results, and multiple result types.

SerpAPI 統合により Google ニュース検索機能を提供する、モデルコンテキストプロトコル(MCP)サーバー実装。ニュース検索結果を自動的に分類し、複数の言語と地域をサポートします。

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

✨ 特徴

🔍 柔軟な検索オプション

クエリベースの検索、トピック検索、公開フィルタリング、ストーリー範囲などの包括的な検索機能。

🌐 グローバルカバレッジ

設定可能な言語および国コードを通じて複数の言語と地域をサポートします。

📊 スマートな分類

ニュース結果を AI とテクノロジー、ビジネス、科学と研究、ヘルスケアなどのトピックに自動的に分類します。

🔀 複数の結果タイプ

見出し、記事、関連トピック、メニュー リンクなど、さまざまなニュース結果タイプを処理します。

🛠️ 堅牢なエラー処理

API 障害や無効な入力に対する包括的なエラー処理と役立つエラー メッセージ。

🌍 言語サポート

サポートされていない言語コードの場合は、適切なユーザー通知とともに自動的に英語にフォールバックします。

🔑 SERP API セットアップガイド

始める前に、SERP APIキーを取得する必要があります。手順は以下のとおりです。

  1. SERP APIウェブサイトにアクセスしてアカウントを作成してください
  2. 登録後、ダッシュボードに移動します。
    • 「APIキー」セクションを見つけます
    • APIキーをコピーする
    • 新規ユーザーは100回のAPI呼び出しが無料
  3. API 使用の詳細:
    • 無料枠: 月間100回の検索
    • 有料プランは月額50ドルからで、検索回数は5000回まで。
    • 成功したAPI呼び出しに基づく課金
    • 複数の支払い方法: クレジットカード、PayPal など。
  4. 使用制限:
    • リクエストレート: 2 リクエスト/秒
    • IP制限: なし
    • 同時リクエスト数: 5
    • レスポンスキャッシュ時間: 1時間

👩‍🔧 NVM/NPM を使用した MCP サーバー接続の問題の解決策

私の構成ソリューションを見るにはクリックしてください👉 https://github.com/modelcontextprotocol/servers/issues/76

🚀 クイックスタート

  1. 依存関係をインストールします:
npm install
  1. 環境を構成する: claude_desktop_config.jsonを次の内容で変更します (システムに応じてパスを調整します)。
"google-news": { "command": "D:\\Program\\nvm\\node.exe", "args": [ "D:\\github_repository\\path_to\\dist\\index.js" ], "env": { "SERP_API_KEY": "your-api-key" } }
  1. サーバーを構築します。
npm run build
  1. サーバーを起動します。
npm start

トラブルシューティング

  1. 無効なAPIキー
  • claude_desktop_config.jsonの API キー設定を確認する
  • SERP APIダッシュボードでAPIキーがアクティブであることを確認します
  1. リクエストの失敗
  • ネットワーク接続を確認する
  • API呼び出しのクォータが超過していないことを確認する
  • リクエストパラメータの形式を検証する

📦 インストール

Smithery経由でインストール

Smithery経由で Claude Desktop に Google ニュースを自動的にインストールするには:

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

mcp-get 経由でインストールする

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

古いバージョンの Windows PowerShell を使用している場合は、このコマンドの前にSet-ExecutionPolicy Bypass -Scope Processを実行する必要がある場合があります。

手動インストール

@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

💻 技術スタック

📖 APIドキュメント

サーバーはモデルコンテキストプロトコルを実装し、次のパラメータを使用して Google ニュース検索ツールを公開します。

  • q : 検索クエリ文字列
  • gl : 国コード(例:「us」、「uk」)
  • hl : 言語コード (例: 'en'、'es')
  • topic_token : 特定のニューストピックのトークン
  • publication_token : 特定の出版社のトークン
  • story_token : ストーリーの完全な報道のためのトークン
  • section_token : 特定のセクションのトークン

🔧 開発

# Run in development mode with hot reload npm run dev # Run linting npm run lint # Run tests npm run test

📝 ライセンス

このプロジェクトはMIT ライセンスです。

🙋‍♀ 著者

Chan Mengによって作成および管理されています。

ID: dbx6imq4ef