home / mcp / mcp rss mcp server

MCP RSS MCP Server

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

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "buhe-mcp_rss": {
      "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": "/PATH/YOUR_FEED_FILE.opml",
        "RSS_UPDATE_INTERVAL": "1"
      }
    }
  }
}

MCP RSS is a server that lets you interact with RSS feeds through the MCP API. It parses OPML subscriptions, fetches updates from feeds, and exposes articles for reading, labeling favorites, and filtering by source or status. This makes it easy to integrate RSS content into your MCP-enabled workflows and applications.

How to use

You connect to the MCP RSS server using an MCP client. Once connected, you can retrieve articles from your subscribed feeds, see available sources, and mark items as favorites. Use the get_content operation to fetch articles with optional filters for status and source, the get_sources operation to list all feeds you subscribe to, and the set_tag operation to change an article’s status between normal and favorite. When you mark articles as favorites, they stand out in your downstream apps and views. You can also filter articles by their source title or by whether they are normal items or favorites to tailor your reading list.

How to install

Prerequisites: you need Node.js (version 14 or higher) and a MySQL database.

Set up MySQL in a container for development/testing.

# Start a MySQL container (example)
docker run -itd --name mysql-test -p 3306:3306 -e MYSQL_ROOT_PASSWORD=123456 mysql

Install and run the MCP RSS server using the stdio communication method. Use the provided example configuration to supply your OPML file path. You must specify your own OPML file path and can customize environment variables as needed.

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

Configuration and how to customize

Configure MCP RSS by setting environment variables. The server expects the following options, with these defaults if you do not override them.

- DB_HOST: Database host (default: localhost)

- DB_PORT: Database port (default: 3306)

- DB_USERNAME: Database user (default: root)

- DB_PASSWORD: Database password (default: 123456)

- DB_DATABASE: Database name (default: mcp_rss)

- OPML_FILE_PATH: Path to your OPML with RSS feeds (default: ./feeds.opml)

- RSS_UPDATE_INTERVAL: Interval to fetch updates in minutes (default: 1)

MCP API Reference (high level)

The MCP RSS server exposes a few core operations to work with RSS content.

- get_content: Retrieve articles from subscribed RSS feeds with optional filters for status (normal or favorite), source (feed title), and limit.

- get_sources: List all available RSS feed sources.

- set_tag: Set the status of a specific article to normal or favorite.

Notes and tips

Keep your OPML file up to date to ensure you subscribe to the right feeds. Regularly adjust the RSS_UPDATE_INTERVAL to balance freshness with network load. Use the get_sources endpoint to understand what feeds are currently available, and use get_content with appropriate filters to build focused reading lists. If you update an article’s status to favorite, it will be easily retrievable through subsequent get_content calls.

Available tools

get_content

Retrieve articles with optional filters for status and source, and limit the number of results.

get_sources

Return all available RSS feed sources with their titles and categories.

set_tag

Change an article's status to normal or favorite by article ID.