MCP Rss Crawler

🚀 MCP-RSS-Crawler 服務器

MCP-RSS-Crawler 服務器基於消息鏈協議（MCP）構建，旨在抓取 RSS 源，並將其與大型語言模型（LLMs）共享，為用戶提供最新的 RSS 資訊。

✨ 主要特性

• 數據抓取與緩存：抓取 RSS 源並將其緩存到 SQLite 數據庫中，方便後續查詢和使用。
• 協議集成：實現 MCP 協議，可與 LLM 進行無縫集成，讓 LLM 能夠訪問最新的 RSS 源。
• 過濾功能：支持按類別、來源或關鍵詞過濾 RSS 源，精準獲取所需信息。
• API 管理：提供全面的 API 端點，可對 RSS 源進行添加、更新和刪除等操作。
• 內容獲取：支持從 Firecrawl 獲取文章內容，豐富信息來源。

📦 安裝指南

安裝要求

• 需具備 Bun 環境。
• 擁有 Firecrawl API 密鑰。
• 準備好 Claude Desktop 或其他 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），LLM 可通過向 MCP 端點發送包含 messages 數組的 POST 請求來獲取最新的 RSS 源信息。

示例請求：

{
  "messages": [
    {
      "role": "user",
      "content": "我的 RSS 源有什麼最新消息？"
    }
  ]
}

示例響應：

{
  "messages": [
    {
      "role": "assistant",
      "content": "以下是你的 RSS 源的最新文章：",
      "name": "rss-mcp"
    },
    {
      "role": "tool",
      "content": "[{\"title\":\"文章標題\",\"summary\":\"文章摘要...\",\"published\":\"2025-03-16T04:30:00.000Z\",\"origin\":\"源名稱\",\"link\":\"https://example.com/article\"}]",
      "name": "rss-feeds"
    }
  ]
}

📚 詳細文檔

配置選項

服務器可通過環境變量或 .env 文件進行配置：

故障排除

• 若出現連接問題，請檢查網絡設置和防火牆配置。
• 可在控制檯查看日誌，用於診斷問題。
• 若需要更詳細的日誌記錄，請在環境變量中設置 DEBUG=mcp-rss:*。