rss-mcp by tsoguri - MCP Server

RSS MCP Server

A Model Context Protocol (MCP) server for RSS feed management and analysis. This server provides tools to discover, parse, filter, and analyze RSS feeds.

I’ve always enjoyed keeping up with the latest news and developments in science and technology, and I was curious what it would look like to explore that information with an LLM. Instead of letting the model do broad, self-defined web searches, I wanted to give it access to curated, trustworthy RSS sources that I already follow.

This project is my way of experimenting with that idea: using structured, high-quality inputs to help an LLM summarize, analyze, and highlight emerging trends from reliable sources.

How I Use It

Here are some example prompts you can use with Claude Desktop once the MCP server is configured (outlined below):

Find the top RSS feeds that publish technology / scientific papers using the web and then use those feeds to get me the top 5 emerging technology breakthroughs in the last week. Give me a short summary and cite your sources.

What are the top trending technology topics this week from various feeds? Cite your sources.

Get top stories from Google News in the last hour. Cite your sources.

By combining curated RSS data with an LLM, this setup produces more transparent, focused summaries — a cleaner way to stay informed while keeping control over where the information comes from.

Features

Feed Discovery: Browse predefined RSS feeds from various sources
Feed Parsing: Parse any RSS feed URL and extract content
Content Filtering: Filter articles by keywords, publication date, or categories
Feed Validation: Check if RSS URLs are accessible and valid
Metadata Access: Get available publications and categories

Installation

Clone the repository:
```
git clone <repository-url>
cd rss-mcp
```

Install dependencies:

# Using uv (recommended)
uv sync

# Or using pip
pip install -r requirements.txt

Test the server:

# Using uv
uv run python -m src.server

# Or using python directly
python -m src/server.py

Setup with Claude Desktop

1. Configure Claude Desktop

Add the RSS MCP server to your Claude Desktop configuration:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "rss-feed": {
      "command": "uv",
      "args": ["run", "python", "/absolute/path/to/rss-mcp/src/server.py"],
      "env": {}
    }
  }
}

Note: Replace /absolute/path/to/rss-mcp with the actual path to your project directory.

2. Alternative Setup (without uv)

If you're not using uv, you can run with Python directly:

{
  "mcpServers": {
    "rss-feed": {
      "command": "python",
      "args": ["/absolute/path/to/rss-mcp/src/server.py"],
      "env": {}
    }
  }
}

3. Restart Claude Desktop

After updating the configuration, restart Claude Desktop to load the MCP server.

Available Tools

The RSS MCP server provides 7 tools:

Tool	Description
`get_feeds`	Get all available RSS feeds with optional category filtering
`parse_feed`	Parse any RSS feed URL and return structured content
`validate_feed_url`	Check if an RSS feed URL is valid and accessible
`get_feed_categories`	Get all available categories from predefined feeds
`get_publications`	Get all available publication names
`get_recent_entries`	Filter feed entries by publication time (last N hours)
`filter_entries_by_keywords`	Filter entries by keywords (include/exclude)

Development

Project Structure

rss-mcp/
├── src/
│   ├── feed/
│   │   ├── base.py          # Core Feed class and parsing logic
│   │   ├── constants.py     # Predefined RSS feeds
│   │   ├── models.py        # Pydantic data models
│   │   └── google.py        # Google News specific implementation
│   ├── tools.py             # MCP business logic functions
│   └── server.py            # MCP server and tool definitions
├── pyproject.toml           # Project dependencies
└── README.md

Adding New Feeds

To add new RSS feeds, edit src/feed/constants.py:

Feed(
    publication="New Source",
    category="Technology",
    url="https://newsource.com/rss.xml",
),