kwp-lab-rss-reader-mcp

RSS Reader MCP

RSS フィードの集約と記事コンテンツの抽出を行う MCP（Model Context Protocol）サーバーです。RSS フィードを登録して記事一覧を取得したり、URL から記事の全コンテンツを抽出して Markdown 形式にしたりできます。

英語 | 中文

🚀 クイックスタート

この MCP サーバーは、Claude Desktop や CherryStudio など、MCP 対応クライアントで使用できます。

Claude Desktop

Claude Desktop の場合は、claude_desktop_config.json ファイルの「mcpServers」セクションに次の設定を追加します。

{
  "mcpServers": {
    "rss-reader": {
      "command": "npx",
      "args": [
        "-y",
        "rss-reader-mcp"
      ]
    }
  }
}

使用例

• RSS フィードの基本的な取得

  BBC News の RSS フィードから最新の見出しを 5 件取得してもらえますか？ URL：https://feeds.bbci.co.uk/news/rss.xml

• 記事全体のコンテンツの抽出

  この記事の全コンテンツを抽出し、Markdown 形式にしてください： https://example.com/news/article-title

🔧 ツールリファレンス

fetch_feed_entries

指定した URL から RSS エントリーを取得します

パラメーター：

• url（必須の文字列）：RSS フィードの URL
• limit（任意の数値）：返すエントリーの最大数（デフォルトは 10、最大 100）

戻り値： フィードのメタデータとエントリー一覧（タイトル、リンク、公開日、概要を含む）を含む JSON オブジェクト

fetch_article_content

URL から記事のコンテンツを抽出し、Markdown 形式にします

パラメーター：

• url（必須の文字列）：記事の URL

戻り値： タイトル、Markdown コンテンツ、ソース URL、タイムスタンプを含む JSON オブジェクト

⚙️ トランスポートと環境変数

このサーバーは 2 種類のトランスポートモードに対応しています。

• stdio（デフォルト）：標準入力／出力を介して通信します。Claude Desktop など、ローカルプロセスを実行するクライアントに適しています。
• httpStream：HTTP ストリーミングを介して通信します。HTTP(S) トランスポートに対応するクライアントや、コンテナ化されたデプロイに適しています。

使用できる環境変数：

• TRANSPORT：トランスポートモードを選択します。stdio（デフォルト）または httpStream を指定します。
• PORT：TRANSPORT=httpStream の場合の待ち受けポート（デフォルトは 8081）。
• MCP_SERVER_HOST：TRANSPORT=httpStream の場合の待ち受けアドレス（デフォルトは localhost）。Docker では、ポートを外部に公開するために 0.0.0.0 を設定します。

トランスポートモードの切り替え方法：

• stdio を使用する場合（追加設定不要、デフォルト）：
  • command + args 設定を使用して Claude Desktop で動作します（上記の例を参照）。
• httpStream を使用する場合：
  • 環境変数 TRANSPORT=httpStream を設定し、PORT を指定します（設定しない場合はデフォルトの 8081）。
  • コンテナで実行する場合は、MCP_SERVER_HOST=0.0.0.0 も設定し、ポートをマッピングします。
  • このリポジトリの Dockerfile には、関連する環境変数の設定がすでに含まれています。

Docker でのデプロイ

この MCP サーバーは Docker コンテナでも実行できます。まず、プロジェクトのルートでイメージをビルドします。

docker build -t rss-reader-mcp .

CherryStudio を例に、HTTP 経由でこのサーバーを実行する設定を以下に示します。

{
  "mcpServers": {
    "rss-reader-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-p",
        "8081:8081",
        "-e",
        "PORT=8081",
        "rss-reader-mcp"
      ]
    }
  }
}

テスト用 RSS フィード

• BBC News： https://feeds.bbci.co.uk/news/rss.xml
• TechCrunch： https://techcrunch.com/feed/
• Hacker News： https://hnrss.org/frontpage
• MIT Technology Review： https://www.technologyreview.com/feed/