MCP RSS

By buhe GitHub

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

Overview

what is MCP RSS?

MCP RSS is a Model Context Protocol (MCP) server designed for interacting with RSS feeds, allowing users to manage and fetch articles from their subscribed feeds.

how to use MCP RSS?

To use MCP RSS, set up a MySQL database, install the server using Node.js, and configure it with your OPML file containing RSS feed subscriptions.

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
Mark articles as favorites
Filter articles by source and status

use cases of MCP RSS?

Managing multiple RSS feeds in one place
Fetching and displaying articles from various sources
Creating a personalized news aggregator

FAQ from MCP RSS?

What are the prerequisites for using MCP RSS?

You need Node.js (v14 or higher) and a MySQL database.

How do I configure the database for MCP RSS?

You can set up a MySQL database using Docker with the provided command in the documentation.

Can I filter articles by their status?

Yes, you can filter articles as normal or favorite using the MCP API.

Content

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

No tools information available.

No content found.