mcp-rss

by buhe
MIT License
12
4

Integrations

  • Uses MySQL as the database backend for storing and managing RSS feed data, articles, and user preferences.

  • Provides tools for parsing and interacting with RSS feeds, including importing subscriptions from OPML files, automatically fetching and updating articles, filtering content by source and status, and marking articles as favorites.

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

OptionDescriptionDefault Value
DB_HOSTDatabase hostlocalhost
DB_PORTDatabase port3306
DB_USERNAMEDatabase usernameroot
DB_PASSWORDDatabase password123456
DB_DATABASEDatabase namemcp_rss
OPML_FILE_PATHPath to your OPML file with RSS feeds"./feeds.opml"
RSS_UPDATE_INTERVALInterval 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:

ParameterTypeDescriptionRequired
statusstringFilter by article status ("normal" or "favorite")No
sourcestringFilter by source (feed title)No
limitnumberMaximum number of articles to returnNo (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:

ParameterTypeDescriptionRequired
statusstringArticle status ("normal" or "favorite")Yes
articleIdnumberID of the article to updateYes

Response:

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

License

MIT

-
security - not tested
A
license - permissive license
-
quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

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

  1. Features
    1. Installation
      1. Prerequisites
      2. Setup MySQL
      3. Install MCP
    2. Configuration
      1. Configuration Options
    3. MCP API Reference
      1. get_content
      2. get_sources
      3. set_tag
    4. License

      Related MCP Servers

      • A
        security
        A
        license
        A
        quality
        A beginner-friendly Model Context Protocol (MCP) server that helps users understand MCP concepts, provides interactive examples, and lists available MCP servers. This server is designed to be a helpful companion for developers working with MCP. Also comes with a huge list of servers you can install.
        Last updated -
        3
        9
        36
        JavaScript
        Apache 2.0
      • A
        security
        A
        license
        A
        quality
        A Model Context Protocol (MCP) server that provides tools for searching and fetching information from Hacker News.
        Last updated -
        4
        6
        Python
        MIT License
        • Apple
      • -
        security
        A
        license
        -
        quality
        An MCP server implementation that integrates the RSS3 API, allowing users to query data from decentralized chains, social media platforms, and the RSS3 network through natural language.
        Last updated -
        1
        JavaScript
        MIT License
      • -
        security
        -
        license
        -
        quality
        A Model Context Protocol (MCP) server that interacts with system APIs, allowing users to check connections, search employees, register breakfast, and update chemical information by shifts.
        Last updated -
        2

      View all related MCP servers

      ID: h241s0f6y5