MCP Newsnow

🚀 MCP ニュースアグリゲーションサーバー

このサーバーは、Model Context Protocol (MCP) に基づいたニュースアグリゲーションサーバーで、Newsnow API を通じて、複数のプラットフォームのホットニュースやトレンドトピックを提供します。

✨ 主な機能

• 多プラットフォームのホットニュース集約：酷安、知乎、微博、B站、抖音、GitHub など 14 以上のプラットフォームからのホットコンテンツを一括で取得できます。
• 英語と中国語のソース名識別：英語と中国語のニュースソース名をサポートし、曖昧検索機能も備えています。
• カスタム API エンドポイント：環境変数またはコマンドライン引数で Newsnow API エンドポイントを設定できます。

📦 インストール

方法一：PyPI からインストール

# pip を使ってインストール
pip install mcp-newsnow

# または uv を使ってインストール
uv pip install mcp-newsnow

方法二：Claude Desktop の設定

Claude Desktop の設定ファイルにサーバー設定を追加します。

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

以下の設定を追加します。

{
  "mcpServers": {
    "get_news": {
      "command": "uvx",
      "args": [
        "mcp-newsnow"
      ]
    }
  }
}

💻 使用例

Claude Desktop を使う場合

1. Claude Desktop をインストールし、設定します。
2. 設定ファイルに上記の MCP サーバー設定を追加します。
3. Claude Desktop を再起動します。
4. チャットでニュース関連のツールを使用します。

MCP CLI を使って開発する場合

# 環境変数で API エンドポイントを設定
NEWS_API_URL=https://newsnow.example.com

# テストを実行
mcp test server.py

基本的な使用法

1. 単一ソースのニュースを取得 (get_newsnow)

async def get_newsnow(source: str) -> dict[str, Any] | None

指定したソースから最新のニュースを取得します。

パラメータ:

• source: ニュースソース名 (英語と中国語をサポート。例: "知乎", "zhihu", "B站" など)

戻り値: ニュースデータを含む辞書

2. 複数ソースのニュースを取得 (get_multi_news)

async def get_multi_news(sources: list[str] = None) -> dict[str, Any]

複数のソース (最大 5 つ) から最新のニュースを取得します。

パラメータ:

• sources: ニュースソース名のリスト

戻り値: 複数のニュースソースのデータを含む辞書

3. すべてのソースのニュースを取得 (get_all_news)

async def get_all_news() -> dict[str, Any]

設定されたすべてのニュースソースのデータを取得します。

戻り値: すべてのニュースソースのデータを含む辞書

4. すべてのソースのニュースを取得 (get_all_news)

async def get_all_news() -> dict[str, Any]

設定されたすべてのニュースソースのデータを取得します。

戻り値: すべてのニュースソースのデータを含む辞書

環境変数

• NEWS_API_URL: Newsnow API のエンドポイントを設定します。デフォルト値はデフォルト URL です。

サポートされるニュースソース

• 酷安 (coolapk)
• 知乎 (zhihu)
• 微博 (weibo)
• B站 (bilibili)
• 抖音 (douyin)
• GitHub (github)

コントリビュートガイド

問題の報告やプルリクエストは大歓迎です！以下はいくつかの改善の方向性です。

1. より多くのニュースソースのサポートを追加する
2. API のパフォーマンスを最適化する
3. エラーハンドリングメカニズムを改善する
4. ログ記録機能を追加する
5. より多くの MCP プロトコルの機能をサポートする

📄 ライセンス

このプロジェクトは MIT License の下で提供されています。