rss

The RSS MCP Server provides a universal tool to fetch and parse RSS/Atom feeds via MCP. It includes built-in support for standard feeds as well as RSSHub-powered feeds through the get_feed tool, with multi-instance resilience. You can query a feed URL, specify how many items to retrieve, and receive a structured JSON representation of the feed including title, link, description, and an array of items with fields like title, description, link, pubDate, author, and category. The server supports both regular URLs and the rsshub:// protocol, automatically routing requests to a available RSSHub instance if needed. Optionally, you can set a PRIORITY_RSSHUB_INSTANCE in a .env file to lock onto a preferred RSSHub instance for faster access.

Prerequisites:

• Node.js (version compatible with the project)
• npm or yarn

Install and run:

1. Clone the repository: git clone https://github.com/veithly/rss-mcp.git cd rss-mcp

2. Install dependencies: npm install

3. Build the TypeScript source (if required by the project): npm run build

4. Start the MCP server: npm start

5. (Optional) Configure a priority RSSHub instance by creating a .env file in the project root: PRIORITY_RSSHUB_INSTANCE=https://my-rsshub.example.com The server will load this on startup and put it at the top of the polling list.

Tips:

• The get_feed tool supports both standard RSS/Atom feeds and RSSHub URLs. Use count to limit results or 0 to fetch all items.
• If a request to one RSSHub instance fails, the server automatically tries the next one in the list until successful.
• You can run the server via npx rss-mcp for quick testing, or install locally and point your MCP client to the absolute path of the compiled index.js when building your own setup.
• If you use a private RSSHub instance, set PRIORITY_RSSHUB_INSTANCE to ensure it is used first.
• Ensure environment variables are loaded (e.g., via dotenv) if you rely on .env configuration.