Rss Mcp

What is Rss Mcp?

Rss Mcp is a Model Context Protocol (MCP) server built with TypeScript that fetches and parses standard RSS and Atom feeds, with dedicated support for RSSHub feeds. It includes a built-in list of public RSSHub instances and an automatic polling mechanism to select an available instance, improving data retrieval reliability. It is intended for language models or any MCP client that needs to consume structured content from web feeds.

How to use Rss Mcp?

Install by cloning the repository (git clone https://github.com/veithly/rss-mcp.git), running npm install, then building with npm run build and starting with npm start. For MCP clients like Cursor, add a rss server entry in the client’s configuration file (e.g., ~/.cursor/mcp_settings.json) using either npx rss-mcp or a direct node path to the compiled dist/index.js. Optionally set a priority RSSHub instance via the PRIORITY_RSSHUB_INSTANCE environment variable. Once configured, call the get_feed tool with a URL (standard or rsshub:// protocol) and an optional item count.

Key features of Rss Mcp

• Fetches and parses any standard RSS or Atom feed.
• Enhanced RSSHub support with multi-instance and automatic fallback.
• Customizable item count, including retrieving all items.
• Smart URL parsing with rsshub:// protocol support.
• Priority instance configuration via environment variable.
• Content cleaning with Cheerio for plain text extraction.

Use cases of Rss Mcp

• Fetching the latest articles or news from any RSS-enabled website.
• Querying RSSHub for platform-specific feeds (e.g., Bilibili user dynamics).
• Integrating structured feed data into conversational AI or automation workflows.
• Reliably retrieving feeds from public RSSHub instances with automatic failover.

FAQ from Rss Mcp

How do I fetch an RSS feed using Rss Mcp?

The server exposes a single tool named get_feed. Provide a required url parameter (either a standard RSS/Atom URL or a simplified rsshub:// route) and an optional count parameter (default 1). The server returns a JSON object with feed metadata and items.

Can I use a private or preferred RSSHub instance?

Yes. Create a .env file in the project root and set PRIORITY_RSSHUB_INSTANCE to your instance URL. The server will place that instance at the top of its polling list, giving it priority.

What happens if an RSSHub instance fails to respond?

The server automatically attempts the next instance from its built-in list until a request succeeds or all instances have been tried. This improves stability without manual intervention.

Does Rss Mcp require any runtime dependencies beyond Node.js?

The server is built with Node.js and uses npm packages (axios, rss-parser, cheerio, etc.). There are no external system dependencies. The package can be run directly via npx without a local installation.

What transport protocol does Rss Mcp use?

The server communicates with the parent process via standard input/output (stdio), which is the standard transport for MCP servers. It is configured as a stdio type in MCP client settings.