News MCP

🚀 📰 ニュースMCPサーバー

信頼性の高いニュース取得のための、自動API切り替え機能を備えたスマートなニュース検索MCP（Model Context Protocol）サーバーです。API制限を心配する必要はもうありません！

🚀 クイックスタート

1. インストール

# リポジトリをクローンする
git clone https://github.com/guangxiangdebizi/news-mcp.git
cd news-mcp

# 依存関係をインストールする
npm install

# 環境変数のテンプレートをコピーする
cp .env.example .env

2. APIの設定

以下のいずれかのサービスから無料のAPIキーを取得してください（1つあれば十分ですが、複数取得すると信頼性が向上します）。

*無料プランで無制限と主張されています

3. 環境変数の設定

.envファイルを編集し、APIキーを追加します。

# 少なくとも1つのAPIキーを追加してください（信頼性のために複数追加すると良いです）
THE_NEWS_API_KEY=your_api_key_here
NEWSDATA_IO_KEY=your_api_key_here
NEWSAPI_ORG_KEY=your_api_key_here
GNEWS_API_KEY=your_api_key_here
TWINGLY_API_KEY=your_api_key_here

4. ビルドと実行

# プロジェクトをビルドする
npm run build

# MCPサーバーを起動する
npm start

# または開発モードで実行する
npm run dev

✨ 主な機能

• 🔄 スマートAPI切り替え：あるAPIが制限に達した場合、自動的に複数のニュースAPI間で切り替えます。
• 🆓 複数の無料API：1日のクォータが豊富な5つ以上の無料ニュースAPIをサポートします。
• 📊 クォータ管理：APIの1日の使用制限をインテリジェントに追跡します。
• 🌍 多言語対応：20種類以上の言語でニュースを検索できます。
• ⚡ 高速かつ信頼性高い：フェイルオーバー機構により、常に結果を取得できます。
• 🛠️ 簡単なセットアップ：環境変数を使用した簡単な設定が可能です。

🔧 使用方法

Claude Desktopでの使用

Claude Desktopの設定に追加します。

標準入出力モード（ローカル開発）：

{
  "mcpServers": {
    "news-mcp": {
      "command": "node",
      "args": ["path/to/news-mcp/build/index.js"]
    }
  }
}

SSEモード（Webアクセス）：

# SSEサーバーを起動する
npm run sse

{
  "mcpServers": {
    "news-mcp": {
      "type": "sse",
      "url": "http://localhost:3100/sse",
      "timeout": 600
    }
  }
}

利用可能なツール

search_news

自動API切り替え機能を備えたニュース記事の検索を行います。

パラメーター:

• query (必須): 検索キーワードまたはトピック
• language (オプション): 言語コード（デフォルト: "en"）
• limit (オプション): 記事の数（1 - 10、デフォルト: 5）

例:

// テクノロジーニュースを検索する
{
  "query": "artificial intelligence",
  "language": "en",
  "limit": 5
}

// 中国語のニュースを検索する
{
  "query": "科技新闻",
  "language": "zh",
  "limit": 3
}

🧠 スマート切り替えの仕組み

1. 優先順位：APIは信頼性とクォータ制限の順に試行されます。
2. クォータ追跡：システムは各APIの1日の使用量を追跡します。
3. 自動フェイルオーバー：APIが失敗または制限に達した場合、自動的に次のAPIを試行します。
4. 成功保証：成功応答が得られるか、すべてのAPIが使い果たされるまで続けます。

TheNewsAPI (∞) → NewsData.io (200) → NewsAPI.org (100) → GNews (100) → Twingly (50)

📊 対応言語

• 英語 (en) - すべてのAPI
• 中国語 (zh) - ほとんどのAPI
• スペイン語 (es) - ほとんどのAPI
• フランス語 (fr) - ほとんどのAPI
• ドイツ語 (de) - ほとんどのAPI
• その他15種類以上の言語

🛠️ 開発

プロジェクト構造

src/
├── index.ts              # MCPサーバーのエントリーポイント
├── config.ts             # API設定管理
└── tools/
    └── newsSearch.ts     # スマートニュース検索ツール

スクリプト

npm run build     # TypeScriptをビルドする
npm run dev       # ウォッチモードで開発する
npm start         # ビルド済みのサーバーを起動する
npm run sse       # ポート3100でSSEサーバーを起動する

新しいAPIの追加

1. src/config.tsにAPI設定を追加します。
2. src/tools/newsSearch.tsにAPI固有のリクエストロジックを実装します。
3. .env.exampleに環境変数を追加します。

🤝 コントリビューション

コントリビューションは大歓迎です！プルリクエストを送信してください。

1. リポジトリをフォークします。
2. 新しい機能ブランチを作成します (git checkout -b feature/AmazingFeature)。
3. 変更をコミットします (git commit -m 'Add some AmazingFeature')。
4. ブランチにプッシュします (git push origin feature/AmazingFeature)。
5. プルリクエストを作成します。

📝 ライセンス

このプロジェクトはApache License 2.0の下でライセンスされています。詳細はLICENSEファイルを参照してください。

👨‍💻 作者

Xingyu Chen

• 🌐 ウェブサイト: GitHub Profile
• 📧 メール: guangxiangdebizi@gmail.com
• 💼 LinkedIn: Xingyu Chen
• 📦 NPM: @xingyuchen

🙏 謝辞

• Model Context Protocolの素晴らしいMCPフレームワーク
• すべてのニュースAPIプロバイダーの寛大な無料プラン
• インスピレーションとサポートを提供してくれたオープンソースコミュニティ

⭐ このプロジェクトが役に立った場合は、スターを付けてください！