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

2. サーバーを構築します。

npm run build

3. 環境を構成する: 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"
      }
    }

4. サーバーを起動します。

npm start

トラブルシューティング

1. 無効なAPIキー

• claude_desktop_config.jsonの API キー設定を確認する

• SERP APIダッシュボードでAPIキーがアクティブであることを確認します

2. リクエストの失敗

• ネットワーク接続を確認する

• API呼び出しのクォータが超過していないことを確認する

• リクエストパラメータの形式を検証する

Related MCP server: Google News13 MCP Server

評価の実行

evalsパッケージはmcpクライアントをロードし、index.tsファイルを実行するため、テスト間で再構築する必要はありません。npxコマンドの先頭に環境変数をロードすることもできます。完全なドキュメントはこちらでご覧いただけます。

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

📦 インストール

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によって作成および管理されています。