README - MCP RSS by buhe

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