Skip to main content
Glama

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

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

local-only server

The server can only run on the client's local machine because it depends on local resources.

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

      • -
        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
        F
        license
        -
        quality
        An MCP server that fetches RSS feeds and shares them with LLMs, allowing AI assistants to access and present the latest news and articles from configured feeds.
        Last updated -
        1
        TypeScript
      • -
        security
        A
        license
        -
        quality
        A FastMCP-based server that provides tools for discovering RSS feeds, fetching and processing news content, searching articles by keyword, and generating summaries across multiple news sources and categories.
        Last updated -
        Python
        MIT License

      View all related MCP servers

      MCP directory API

      We provide all the information about MCP servers via our MCP API.

      curl -X GET 'https://glama.ai/api/mcp/v1/servers/buhe/mcp_rss'

      If you have feedback or need assistance with the MCP directory API, please join our Discord server