Fire in da houseTop Tip:Paying $100+ per month for Perplexity, MidJourney, Runway, ChatGPT and other tools is crazy - get all your AI tools in one site starting at $15 per month with Galaxy AI Fire in da houseCheck it out free

mcp_rss

MCP.Pizza Chef: buhe

MCP RSS is a Model Context Protocol server designed to interact with RSS feeds by parsing OPML files, automatically fetching and updating articles, and exposing RSS content through a standardized MCP API. It supports marking articles as favorites and filtering by source or status, enabling seamless integration of RSS feed data into AI workflows and applications.

Use This MCP server To

Import RSS feed subscriptions from OPML files Automatically fetch and update articles from multiple RSS feeds Expose RSS feed content to LLMs via MCP API Filter RSS articles by source or read/unread status Mark and manage favorite articles within RSS feeds

README

MCP RSS

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

Features

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

Installation

Prerequisites

  • Node.js (v14 or higher)
  • MySQL database

Setup MySQL

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

Install MCP

This MCP uses stdio for communication. Fill in npx mcp_rss in the command, fill in the configuration that needs to be customized in the environment variable, and at least use your own opml file.

Use in claude desktop

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

Configuration

Set the following environment variables to configure MCP RSS:

Configuration Options

Option Description Default Value
DB_HOST Database host localhost
DB_PORT Database port 3306
DB_USERNAME Database username root
DB_PASSWORD Database password 123456
DB_DATABASE Database name mcp_rss
OPML_FILE_PATH Path to your OPML file with RSS feeds "./feeds.opml"
RSS_UPDATE_INTERVAL Interval to fetch RSS updates (in minutes) 1

MCP API Reference

The MCP RSS server exposes the following API methods:

get_content

Get articles from subscribed RSS feeds.

Parameters:

Parameter Type Description Required
status string Filter by article status ("normal" or "favorite") No
source string Filter by source (feed title) No
limit number Maximum number of articles to return No (default: 10)

Response:

{
  "articles": [
    {
      "id": 1,
      "title": "Article Title",
      "content": "Article content...",
      "link": "https://example.com/article",
      "pubDate": "2023-01-01T12:00:00Z",
      "fetchDate": "2023-01-01T12:30:00Z",
      "status": "normal",
      "feedTitle": "Example Feed",
      "feedCategory": "Technology"
    }
  ],
  "success": true
}

get_sources

Get all available RSS feed sources.

Parameters: None

Response:

{
  "sources": [
    {
      "id": 1,
      "title": "Example Feed",
      "category": "Technology"
    }
  ],
  "success": true
}

set_tag

Set the status of an article (normal or favorite).

Parameters:

Parameter Type Description Required
status string Article status ("normal" or "favorite") Yes
articleId number ID of the article to update Yes

Response:

{
  "success": true,
  "message": "Article 1 status has been updated to favorite"
}

License

MIT

mcp_rss FAQ

How do I install MCP RSS?
Install Node.js v14+, set up a MySQL database, then run 'npx mcp_rss' with your OPML file configured via environment variables.
What is the role of the OPML file in MCP RSS?
The OPML file is used to import and manage your RSS feed subscriptions automatically.
How does MCP RSS communicate with the host application?
MCP RSS uses stdio for communication, allowing integration with MCP hosts like Claude Desktop.
Can I filter articles by their read or favorite status?
Yes, MCP RSS supports filtering articles by source, read/unread status, and marking favorites.
What database does MCP RSS require?
MCP RSS requires a MySQL database to store feed and article data.
Is MCP RSS compatible with multiple MCP hosts?
Yes, MCP RSS is designed to work with any MCP host supporting the MCP protocol.
How often does MCP RSS update RSS feed articles?
MCP RSS automatically fetches and updates articles based on the configured feed refresh intervals.
Can MCP RSS handle large numbers of RSS feeds?
Yes, it efficiently manages multiple feeds imported via OPML and updates them automatically.