MCP Rss

🚀 MCP RSS Server

MCP RSS is a Model Context Protocol (MCP) server designed to interact with RSS feeds.

🚀 Quick Start

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

✨ Features

• Parse OPML files to import RSS subscription sources.
• Automatically fetch and update articles from RSS feeds.
• Expose RSS content through the MCP API.
• Mark articles as favorites.
• Filter articles by source and status.

📦 Installation

Prerequisites

• Node.js (v14 or higher)
• MySQL database

Set up MySQL

$ docker run -itd --name mysql-test -p 3306:3306 -e MYSQL_ROOT_PASSWORD=123456 mysql

Install MCP

This MCP uses standard input and output for communication. Enter npx mcp_rss in the console, and fill in the custom configuration information in the environment variables. At least use your own OPML file.

For Claude Desktop:

{
  "key": "rss",
  "command": "npx",
  "args": [
    "mcp_rss"
  ],
  "env": {
    "OPML_FILE_PATH": "/Users/guyanhua/feeds.opml"
  }
}

📚 Documentation

Configure MCP RSS by setting the following environment variables:

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 Source",
      "feedCategory": "Technology"
    }
  ],
  "success": true
}

get_sources

Get all available RSS sources.

Parameters: None

Response:

{
  "sources": [
    {
      "id": 1,
      "title": "Example Source",
      "category": "Technology"
    }
  ],
  "success": true
}

set_tag

Set the status of an article (normal or favorite).

Parameters:

Response:

{
  "success": true,
  "message": "The status of article 1 has been changed to favorite"
}

📄 License

MIT