MCP RSS

What is MCP RSS?

MCP RSS is a Model Context Protocol (MCP) server for interacting with RSS feeds. It imports feed subscriptions from OPML files, fetches and updates articles automatically, and exposes RSS content through a defined API, intended for use with MCP‑compatible clients like Claude Desktop.

How to use MCP RSS?

Install Node.js v14 or higher and a MySQL database. Run via npx mcp_rss with environment variables configured at minimum an OPML_FILE_PATH pointing to your OPML file. In Claude Desktop, define the command as npx mcp_rss and pass the required environment variables.

Key features of MCP RSS

• Parse OPML files to import RSS feed subscriptions
• Automatically fetch and update articles from RSS feeds
• Expose RSS content through MCP API methods
• Mark articles as favorites
• Filter articles by source and status

Use cases of MCP RSS

• Read and manage RSS feed content from within an MCP client
• Import an existing OPML subscription list and keep it updated
• Curate a reading list by starring favorite articles
• Search or filter articles by feed source or read status

FAQ from MCP RSS

How do I set up the MySQL database for MCP RSS?

Run the provided Docker command: docker run -itd --name mysql-test -p 3306:3306 -e MYSQL_ROOT_PASSWORD=123456 mysql. The server expects a MySQL instance with the credentials configured via environment variables.

What configuration options are available?

Key environment variables include DB_HOST, DB_PORT, DB_USERNAME, DB_PASSWORD, DB_DATABASE, OPML_FILE_PATH, and RSS_UPDATE_INTERVAL (default 1 minute). See the configuration table for details.

What MCP API methods does MCP RSS expose?

Three methods: get_content (fetch articles with optional status/source/limit filters), get_sources (list all feeds), and set_tag (change an article’s status to “normal” or “favorite”).

How do I filter articles by source or status?

Use the get_content method with optional status (“normal” or “favorite”) and source (feed title) parameters.

What are the prerequisites to use MCP RSS?

Node.js v14 or higher and a running MySQL database. The server communicates over stdio and requires an OPML file for feed subscriptions.