Newsmcp With Mediastackapi

🚀 Mediastack News MCP Server

MediastackニュースAPIをMCP（Model Context Protocol）ツールとして公開するFastMCPサーバーです。このサーバーは、Smithery.aiやその他のMCP互換エージェントプラットフォームのプラグアンドプレイバックエンドとして使用できます。

✨ 主な機能

• get_latest_news：様々なフィルタリングオプションで最新のニュース記事を取得します。
• get_sources：フィルタリング機能を備えた利用可能なニュースソースをリスト表示します。

📦 インストール

1. このリポジトリをクローンします：

   git clone <repository-url>
   cd NewsMCP_with_MediastackAPI
   

2. 必要なPythonパッケージをインストールします：

   pip install -r requirements.txt
   

⚙️ 設定

このサーバーを動作させるには、MediastackのAPIキーが必要です。

1. mediastack.com から無料のAPIキーを取得します。
2. プロジェクトのルートディレクトリに .env という名前のファイルを作成します。
3. このファイルに以下の形式でAPIキーを追加します：

   MEDIASTACK_API_KEY=your_api_key_here
   

ツールが呼び出されると、サーバーは自動的にこの環境変数を読み込みます。

💻 ローカルでの実行

MCPサーバーを起動するには、以下のコマンドを実行します：

python server.py

デフォルトでは、サーバーは http://0.0.0.0:8080 で起動します。

🛠️ 利用可能なツール

1. get_latest_news

Mediastackから最新のニュース記事を取得します。

パラメーター：

• keywords（オプション）：ニュースをフィルタリングする検索用語。
• sources（オプション）：ニュースソース（カンマ区切り、例："cnn,bbc"）。
• countries（オプション）：国コード（カンマ区切り、例："us,gb"）。
• languages（オプション）：言語コード（カンマ区切り、例："en,fr"）。
• categories（オプション）：ニュースカテゴリー（カンマ区切り）。
• date（オプション）：特定の日付または日付範囲（YYYY-MM-DD）。
• sort（オプション）：並び順（published_desc, published_asc, popularity）。
• limit（オプション）：返す結果の最大数（デフォルト：25、最大：100）。
• offset（オプション）：ページネーションのオフセット。

2. get_sources

Mediastackから利用可能なニュースソースをリスト表示します。

パラメーター：

• search（オプション）：ソースをフィルタリングする検索用語。
• sources（オプション）：特定のソース（カンマ区切り）。
• countries（オプション）：国コード（カンマ区切り）。
• languages（オプション）：言語コード（カンマ区切り）。
• categories（オプション）：ニュースカテゴリー（カンマ区切り）。
• limit（オプション）：返す結果の最大数（デフォルト：25、最大：100）。
• offset（オプション）：ページネーションのオフセット。

☁️ Smithery.aiでのデプロイ

1. このリポジトリをGitHubにプッシュします。
2. あなたのGitHubリポジトリをSmithery.aiに接続します。
3. Smitheryは自動的に smithery.yaml 設定を検出します。
4. Smitheryの環境変数に MEDIASTACK_API_KEY を設定します。
5. デプロイしてMCPツールを使用し始めます。

詳細については、Smithery.ai Documentation を参照してください。

📂 プロジェクト構造

.
├── app.py           # MCPツールの定義
├── server.py        # FastMCPサーバーのセットアップ
├── requirements.txt # Pythonの依存関係
├── smithery.yaml    # Smitheryのデプロイ設定
├── Dockerfile       # Dockerイメージのビルド手順
├── LICENSE          # プロジェクトのライセンス
├── .env             # （ローカル）環境変数
└── README.md        # このファイル

📄 ライセンス

このプロジェクトは MIT License の下でライセンスされています。