MCP RSS

Name: MCP RSS
Author: buhe

@buhe

Repository

About MCP RSS

MCP RSS is a Model Context Protocol (MCP) server for interacting with RSS feeds.

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp_rss": {
      "command": "npx",
      "args": [
        "mcp_rss"
      ],
      "env": {
        "OPML_FILE_PATH": "/PATH/YOUR_FEED_FILE.opml"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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”).