What is Mcp Rss

mcp_rss is a Model Context Protocol (MCP) server designed for interacting with RSS feeds, allowing users to manage and retrieve content from various RSS sources.

Use cases

Use cases for mcp_rss include building a personalized news aggregator, developing a content management system that pulls articles from different sources, and creating applications that allow users to track their favorite topics through RSS feeds.

How to use

To use mcp_rss, install Node.js and set up a MySQL database. Run the command ‘npx mcp_rss’ with the necessary environment variables, including the path to your OPML file containing RSS feeds.

Key features

Key features of mcp_rss include parsing OPML files to import RSS feed subscriptions, automatically fetching and updating articles from RSS feeds, exposing RSS content through an MCP API, marking articles as favorites, and filtering articles by source and status.

Where to use

mcp_rss can be used in various fields such as content aggregation, news applications, and any platform that requires real-time updates from multiple RSS feeds.

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

MCP API Reference

The MCP RSS server exposes the following API methods:

get_content

Get articles from subscribed RSS feeds.

Parameters:

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:

Response:

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

License

MIT