MCP Rss Aggregator

What imprvhub/mcp-rss-aggregator MCP server does

The imprvhub/mcp-rss-aggregator MCP server connects Claude Desktop to a user-managed collection of RSS feeds. It retrieves article information and presents results with titles, snippets, and links. Feeds can be grouped into categories, allowing reading by topic as well as by individual source.

The project supports importing subscriptions from OPML, a format commonly exported by RSS readers. It also accepts a JSON feed list containing fields such as title, RSS URL, website URL, and category. A sample OPML file is included for initial testing.

How it works

Claude Desktop starts the server as a local subprocess through its MCP configuration. The server reads the configured OPML or JSON file, then accesses the feed URLs over the internet when requests are made. After changing the feed file or its configured path, Claude Desktop must be restarted so the updated configuration is loaded.

The exposed tool is named rss. It supports requests for the newest articles across all feeds, top articles, the complete feed list, articles from one feed, or articles in a named category. An optional numeric limit can control how many results are returned. Natural-language requests can also be interpreted by Claude and mapped to these operations.

Setup and configuration

To run the imprvhub/mcp-rss-aggregator MCP server manually, clone the repository, install its npm dependencies, build the project, and run node build/index.js from the project directory. The documented runtime requirement is Node.js 16 or newer.

For automatic startup, add an rssAggregator entry to Claude Desktop's claude_desktop_config.json. Its command is node, with the built build/index.js file as an argument. The configuration can also include feedsPath, pointing to an OPML or JSON file. If that setting is omitted, the included sample feeds file is used. The path values in the examples must be replaced with real absolute paths on the host system.

Tools and capabilities

The rss tool provides these command patterns:

• latest: retrieve recent articles from all configured feeds.
• top or best: retrieve top articles from all feeds.
• list: show configured feeds.
• --[feed-id]: retrieve articles from a selected feed.
• [category]: retrieve articles assigned to a category.
• set-feeds-path: change the OPML or JSON source path.

Requests can include a result limit, such as latest --20 or a feed-specific query with --15. Categories and feed identifiers depend on the configured subscription data.

Limitations and notes

The server is documented for Claude Desktop and does not list compatibility with other MCP clients. It depends on network access to reach RSS feeds, so unavailable or unreachable sources may affect results. The repository instructions describe local installation and execution; no hosted endpoint or API credential configuration is provided.

The imprvhub/mcp-rss-aggregator MCP server does not act as an RSS subscription editor with a separate online account. Feed changes are made by editing or replacing the local OPML or JSON file, or by using the documented path-setting command. Claude Desktop needs to be restarted after configuration changes made in its JSON configuration file.