RSS MCP

An MCP server that provides RSS feed tools for Claude Desktop. Fetches and parses RSS feeds, returning structured article data.

Requirements

• Python 3.13+
• uv - Install with:

  curl -LsSf https://astral.sh/uv/install.sh | sh
  

Installation

git clone https://github.com/YOUR_USERNAME/rss-mcp.git
cd rss-mcp
uv sync

Claude Desktop Configuration

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "rss-mcp": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/rss-mcp", "python", "main.py"]
    }
  }
}

Replace /path/to/rss-mcp with the actual path to your cloned repository.

Configuration

Edit feeds.json to customize feeds and filtering:

{
  "feeds": {
    "tech": {
      "url": "https://hnrss.org/newest",
      "description": "Tech news from Hacker News",
      "limit": 20
    },
    "news": {
      "url": "https://www.wyff4.com/topstories-rss",
      "description": "Local and national news"
    }
  },
  "blocklist": ["crypto", "nft", "sponsored"]
}

• feeds: Named feeds that become tools (e.g., get_tech_feed, get_news_feed)
  • url: RSS feed URL (required)
  • description: Tool description shown in Claude (optional)
  • limit: Max entries to return (optional)
• blocklist: Topics to filter out - passed to Claude for semantic filtering (e.g., "animals" filters out dog/cat/wildlife stories)

Note: Restart Claude Desktop after editing feeds.json for changes to take effect.

Available Tools

• fetch_rss(url, limit) - Fetch any RSS feed by URL
• get_{name}_feed - One tool per configured feed in feeds.json

Development

# Run the server directly
uv run python main.py

# Debug with MCP inspector
uv run mcp dev main.py

# Lint
uv run ruff check .

# Type check
uv run ty check

License

MIT