MCP-RSS-Crawler

一个 MCP (消息链协议) 服务器，用于获取 RSS 订阅源并与 LLM 共享。

特性

• 获取和缓存 RSS 订阅源 (SQLite 数据库)
• MCP 协议实现，实现与 LLM 的无缝集成
• 支持按类别、来源或关键字过滤订阅源
• 完整的 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 协议

该服务器实现了消息链协议 (MCP)，允许 LLM 访问您最新的 RSS 订阅源。 MCP 端点接受带有 JSON 格式的消息数组的 POST 请求，并返回包含最新订阅源项目的响应。

示例请求:

{
  "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 文件配置服务器：

• PORT - 服务器端口 (默认: 5556)
• FIRECRAWL_API_KEY - Firecrawl API 密钥
• DB_DIR - 数据库目录 (默认: ~/.mcp-rss-crawler)

故障排除

• 对于连接问题，请检查您的网络设置和防火墙配置
• 日志在控制台中可用，可用于诊断问题
• 要获得更详细的日志记录，请设置 DEBUG=mcp-rss:* 环境变量