MCP-RSS-Crawler

by mshk

Integrations

  • Supports configuration through environment variables or a .env file for server settings

  • Uses Bun as the runtime environment for the MCP server with specific installation and execution requirements

  • Fetches RSS feeds, allowing filtering by category, source, or keywords, and provides access to latest articles from configured feeds

MCP-RSS爬虫

一个 MCP(消息链协议)服务器,用于获取 RSS 提要并与 LLM 共享。

特征

  • 获取和缓存 RSS 源(SQLite 数据库)
  • MCP 协议实现无缝 LLM 集成
  • 支持按类别、来源或关键字过滤信息
  • 用于 Feed 管理的综合 API 端点
    • 添加、更新和删除 Feed
  • 支持从 Firecrawl 获取文章

要求

  • 包子
  • 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>" } } } }
  1. 安装依赖项:
    bun install
  2. 启动 Claude Desktop:

MCP 协议

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

示例请求:

{ "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:*环境变量
-
security - not tested
F
license - not found
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

MCP 服务器获取 RSS 提要并与 LLM 共享,从而允许 AI 助手访问和呈现来自配置的提要的最新新闻和文章。

  1. Features
    1. Requirements
      1. Setup as MCP Server
        1. MCP Protocol
          1. Configuration Options
            1. Troubleshooting
              ID: e0c6xmkjmf