mcp-rss-aggregator

The MCP RSS Aggregator is a Node.js-based server that exposes an MCP-compatible interface to fetch and present RSS feed items inside Claude Desktop. It reads feeds from an OPML or JSON configuration and serves commands via the built-in rss tool, allowing you to list feeds, fetch the latest or top articles, filter by feed or category, and load a custom OPML/JSON file. Once running, Claude Desktop can automatically start this MCP when needed, and you can interact with it through the rss command set to retrieve formatted article summaries with titles, snippets, and links.

Prerequisites:

• Node.js 16 or higher
• npm (comes with Node.js)
• Claude Desktop (for integration)

Installation steps:

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

2. Install dependencies: npm install

3. Build the project (produces build/index.js): npm run build

4. Run manually (optional, for testing): node build/index.js

5. Configure Claude Desktop to automatically start the MCP when needed by editing claude_desktop_config.json and adding the rssAggregator server with the appropriate absolute path to build/index.js, as shown in the README.

Tips and common scenarios:

• Ensure your feeds file path (OPML/JSON) is accessible and correctly formatted. If you omit the feedsPath, a sample feeds file may be used.
• When using Claude Desktop, restart the application after modifying the configuration so the MCP is loaded properly.
• The available commands for the RSS Aggregator include: latest, top (or best), list, and filtering by feed (--feed-id) or category (e.g., "Tech News"). You can also set the feeds path at runtime with rss set-feeds-path --/path/to/feeds.opml.
• If you see connectivity issues, confirm that the MCP process has permission to access the internet and that your OPML/JSON file is well-formed.
• The server runs as a subprocess managed by Claude Desktop; keep the terminal closed if you’re relying on automatic startup via Claude.