MCP RSS

Provides an MCP server to fetch, organize, and expose RSS feed content via an API with OPML import and article tagging.

javascript

GitHub Stars

javascript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "xrusjohn-mcp_rss_buhe": {
      "command": "npx",
      "args": [
        "mcp_rss"
      ],
      "env": {
        "DB_HOST": "localhost",
        "DB_PORT": "3306",
        "DB_DATABASE": "mcp_rss",
        "DB_PASSWORD": "123456",
        "DB_USERNAME": "root",
        "OPML_FILE_PATH": "/Users/guyanhua/feeds.opml",
        "RSS_UPDATE_INTERVAL": "1"
      }
    }
  }
}

MCP RSS is a server that bridges RSS feeds into the MCP API, letting you subscribe to feeds, fetch and store articles, mark favorites, and filter by source or status. It keeps your RSS content available through MCP requests so you can build dashboards and automate reading lists from your feeds.

How to use

You interact with MCP RSS by running the server as an MCP endpoint and then querying it with an MCP client. Use the client’s get_content method to retrieve articles from your subscribed feeds, optionally filtering by status (normal or favorite) and by source. You can mark articles as favorites with set_tag and then filter your results to surface only the items you care about. You can also list all available sources to understand your subscription options.

Typical usage patterns include starting the server, ensuring your OPML subscriptions are loaded, and then regularly polling for updates. The server automatically fetches and updates articles from your RSS feeds at a configured interval, and you can use the API to fetch recent content or review your favorites.

How to install

Prerequisites you need before starting are Node.js version 14 or higher and a MySQL database instance.

Prepare MySQL (example using Docker):

$ docker run -itd --name mysql-test -p 3306:3306 -e MYSQL_ROOT_PASSWORD=123456 mysql

Install the MCP RSS server. This setup uses stdio for communication. Run the MCP with your MCP client by providing the following command and environment configuration. You will need an OPML file with your subscriptions placed at a path you own.

{
  "key": "rss",
  "command": "npx",
  "args": [
    "mcp_rss"
  ],
  "env": {
    "OPML_FILE_PATH": "/Users/your_user/feeds.opml"
  }
}

Configuration notes

Configure the server using the following environment variables. You can place these in your deployment environment or in your orchestration tool. The variables specify database connection details, the location of your OPML file, and how often the server fetches updates.

DB_HOST=localhost
DB_PORT=3306
DB_USERNAME=root
DB_PASSWORD=123456
DB_DATABASE=mcp_rss
OPML_FILE_PATH=./feeds.opml
RSS_UPDATE_INTERVAL=1

API and sources overview

The MCP RSS server exposes endpoints to get content and sources, and to set the status of articles. Use get_content to retrieve articles with optional filters for status and source and a limit on results. Use get_sources to list all available RSS feed sources, and set_tag to mark an article as normal or favorite.

Examples and tips

Ensure your OPML file contains all of your RSS subscriptions so the server can fetch articles automatically.
Use the OPML_FILE_PATH environment variable to point to your feeds.opml file. For local development, you might set it to a path like "/Users/you/feeds.opml".

Available tools

get_content

Retrieve articles from subscribed RSS feeds with optional filters for status, source, and limit.

get_sources

Fetch all available RSS feed sources and their metadata.

set_tag

Update the status of a specific article to normal or favorite.

Built by

VeilStrat

AI signals for GTM teams