Uses Bun as the runtime environment for the MCP server with specific installation and execution requirements
Supports configuration through environment variables or a .env file for server settings
Fetches RSS feeds, allowing filtering by category, source, or keywords, and provides access to latest articles from configured feeds
Stores and caches fetched RSS feeds in a local database for persistence and efficient retrieval
MCP-RSS-Crawler
An MCP (Message Chain Protocol) server that fetches RSS feeds and shares them with LLMs.
Features
Fetching and caching of RSS feeds (SQLite database)
MCP protocol implementation for seamless LLM integration
Support for filtering feeds by category, source, or keywords
Comprehensive API endpoints for feed management
Add, update, and delete feeds
Support for fetching articles from Firecrawl
Related MCP server: mcp-rss
Requirements
Bun
Firecrawl API key
Claude Desktop or other MCP client
Setup as MCP Server
Clone this repository
Create a
claude_desktop_config.jsonfile based onclaude_desktop_config.json.examplewith your configuration
Install dependencies:
bun installStart Claude Desktop:
MCP Protocol
The server implements the Message Chain Protocol (MCP) which allows LLMs to access your latest RSS feeds. The MCP endpoint accepts POST requests with a JSON body containing a messages array and returns a response with the latest feed items.
Example request:
Example response:
Configuration Options
The server can be configured through environment variables or a .env file:
PORT- Server port (default: 5556)FIRECRAWL_API_KEY- Firecrawl API keyDB_DIR- Database directory (default:~/.mcp-rss-crawler)
Troubleshooting
For connection issues, check your network settings and firewall configuration
Logs are available in the console and can be used to diagnose problems
For more detailed logging, set the
DEBUG=mcp-rss:*environment variable