GNews

📡 GNews API MCP サーバー

このドキュメントでは、GNews API を公開する**Model Context Protocol（MCP）**サーバーについて説明します。

このサーバーはすでにデプロイされ、一般公開されているため、インストールは不要です。 互換性のある MCP クライアント（Claude Code、Gemini CLI など）に接続するだけです。

---

🔑 GNews API キー

このサーバーを使用するには、有効なGNews APIキーが必要です。

👉 こちらから API キーを取得

API キーは次の方法で指定する必要があります。

• HTTP ヘッダー X-Api-Key を使用

---

🔗 MCP 連携

このサーバーは、公式 MCP Registry に io.github.gnews-io/gnews として登録されています。

Claude Code の場合

次のコマンドを使用して、Claude Code の設定にサーバーを追加します。

claude mcp add --transport http gnews_api https://mcp.gnews.io/ --header "X-Api-Key: YOUR_API_KEY"

🛠️ 利用可能なツール

サーバーに接続すると、次の 2 つのツールを利用できます。

• search：キーワードを組み合わせてニュース記事を検索します。
• top_headlines：カテゴリと国を指定して、トップニュースを取得します。

---

📄 使用例

記事を検索する

この例では、気候変動に関する最新の英語記事 5 件を検索します。

{
  "tool": "search",
  "args": {
    "q": "climate change",
    "lang": "en",
    "max": 5
  }
}

最新のヘッドラインを取得する

この例では、米国の「technology」カテゴリからトップニュース 5 件を取得します。

{
  "tool": "top_headlines",
  "args": {
    "category": "technology",
    "country": "us",
    "max": 5
  }
}

---

🔒 セキュリティ

• API キーは決して共有しないでください。パスワードと同様に扱ってください。
• このサーバーはプロキシとして動作し、API キーを一切保存しません。 リクエストごとに、キーはGNews APIへ直接送信されます。
• キーが通信中に暗号化されるよう、サーバーとの通信には必ずHTTPS接続を使用してください。
• ホスト型サーバーは、各ツール呼び出しについて、ツール名、MCP クライアント名とバージョン、成功またはエラー、所要時間、および lang、country、category、max、page、sortby の各パラメーターを含む匿名の使用統計を記録します。 API キーは一方向ハッシュとしてのみ記録され、検索クエリが記録されることはありません。

---

📋 クライアントの前提条件

• 互換性のある MCP クライアント（例：Claude Code）。
• 最適な互換性を得るため、最新バージョンのGemini CLIを推奨します。