MCP-RSS-Crawler

MCP-RSS-Crawler

RSS フィードを取得し、LLM と共有する MCP（Message Chain Protocol）サーバーです。

機能

• RSS フィードの取得とキャッシュ（SQLite データベース）
• LLM とシームレスに統合する MCP プロトコルの実装
• カテゴリ、ソース、キーワードによるフィードのフィルタリングに対応
• フィード管理のための包括的な API エンドポイント
  • フィードの追加、更新、削除
• Firecrawl からの記事の取得に対応

要件

• Bun
• Firecrawl API キー
• Claude Desktop またはその他の MCP クライアント

MCP サーバーとしてのセットアップ

1. このリポジトリをクローンします
2. 設定に基づいて claude_desktop_config.json.example を参考に、claude_desktop_config.json ファイルを作成します

{
  "mcpServers": {
    "rss-crawler": {
      "command": "/path/to/bun",
      "args": ["run", "/path/to/mcp-rss-crawler/apps/mcp-server/src/mcp-cli.ts"],
      "cwd": "/path/to/mcp-rss-crawler",
      "env": {
        "PORT": "5556",
        "DB_DIR": "/path/to/mcp-rss-crawler",
        "FIRECRAWL_API_KEY": "fc-<YOUR_FIRECRAWL_API_KEY>"
      }
    }
  }
}

3. 依存関係をインストールします：

   bun install
   

4. Claude Desktop を起動します：

MCP プロトコル

このサーバーは Message Chain Protocol（MCP）を実装しており、LLM が最新の RSS フィードにアクセスできます。MCP エンドポイントは、messages 配列を含む JSON ボディの POST リクエストを受け付け、最新のフィード項目を含むレスポンスを返します。

リクエスト例：

{
  "messages": [
    {
      "role": "user",
      "content": "What are the latest news from my RSS feeds?"
    }
  ]
}

レスポンス例：

{
  "messages": [
    {
      "role": "assistant",
      "content": "Here are the latest articles from your RSS feeds:",
      "name": "rss-mcp"
    },
    {
      "role": "tool",
      "content": "[{\"title\":\"Article Title\",\"summary\":\"Article summary...\",\"published\":\"2025-03-16T04:30:00.000Z\",\"origin\":\"Feed Name\",\"link\":\"https://example.com/article\"}]",
      "name": "rss-feeds"
    }
  ]
}

設定オプション

サーバーは環境変数または .env ファイルで設定できます：

• PORT - サーバーポート（デフォルト：5556）
• FIRECRAWL_API_KEY - Firecrawl API キー
• DB_DIR - データベースディレクトリ（デフォルト：~/.mcp-rss-crawler）

トラブルシューティング

• 接続に問題がある場合は、ネットワーク設定とファイアウォールの設定を確認してください
• ログはコンソールで確認でき、問題の診断に使用できます
• より詳細なログを出力するには、環境変数 DEBUG=mcp-rss:* を設定してください