MCP RSS Feed Searcher

An extensible Model Context Protocol (MCP) server for searching across multiple RSS feed sources. Built for developers who want to aggregate content from various sources through a unified interface.

🌟 Features

• Multi-Source Search: Search across multiple RSS feeds simultaneously
• Extensible Architecture: Easy to add new feed sources
• MCP Protocol Support: Compatible with MCP Inspector and other MCP clients
• Multiple Transport Modes: STDIO and HTTP support
• Built-in Feeds:
  • FreeCodeCamp News (programming tutorials)
  • FreeCodeCamp YouTube (video content)
  • Bing News (general news search)

🚀 Quick Start

Installation

# Clone the repository
git clone https://github.com/yourusername/mcp-rss-feed-searcher.git
cd mcp-rss-feed-searcher

# Create virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

Running the Server

STDIO Mode (Default):

python main.py

HTTP Mode:

python main.py --mode http

Testing with MCP Inspector

# STDIO mode
npx @modelcontextprotocol/inspector python main.py --mode stdio

# HTTP mode (run in background)
python main.py --mode http &
npx @modelcontextprotocol/inspector http://localhost:8003/mcp

📚 Available MCP Tools

Tool	Description
list_feeds	List all available feed sources
search_feed	Search a specific feed by name
search_all_feeds	Search across all feeds simultaneously
search_multiple_feeds	Search specific multiple feeds

Example Usage

List available feeds:

{
  "tool": "list_feeds"
}

Search a specific feed:

{
  "tool": "search_feed",
  "arguments": {
    "feed_name": "freecodecamp_news",
    "query": "python tutorial",
    "max_results": 5
  }
}

Search all feeds:

{
  "tool": "search_all_feeds",
  "arguments": {
    "query": "machine learning",
    "max_results": 3
  }
}

Search multiple specific feeds:

{
  "tool": "search_multiple_feeds",
  "arguments": {
    "feed_names": ["freecodecamp_news", "bing_news"],
    "query": "artificial intelligence",
    "max_results": 5
  }
}

🏗️ Project Structure

mcp-rss-feed-searcher/
├── src/
│   ├── __init__.py
│   ├── mcp_server.py        # MCP server implementation
│   └── feeds/
│       ├── __init__.py      # Feed package initialization
│       ├── base.py          # BaseFeed abstract class
│       ├── registry.py      # Feed registry system
│       ├── freecodecamp.py  # FreeCodeCamp feeds
│       └── bing_news.py     # Bing News feed
├── input_data/              # Input data directory
├── output_data/             # Output data directory
├── main.py                  # Entry point
├── requirements.txt         # Dependencies
└── README.md               # This file

🔧 Available Feed Sources

FreeCodeCamp News

• Name: freecodecamp_news
• Content: Programming tutorials, tech articles, coding guides
• Source: https://www.freecodecamp.org/news/rss/

FreeCodeCamp YouTube

• Name: freecodecamp_youtube
• Content: Video tutorials, full courses, programming walkthroughs
• Source: YouTube channel RSS feed

Bing News

• Name: bing_news
• Content: Latest news articles across all topics
• Source: Bing News RSS search
• Note: Dynamic feed based on search query

🛠️ Troubleshooting

Common Issues and Solutions

MCP Inspector won't connect

Issue: MCP Inspector fails to connect to the server Solutions:

• Ensure you're using the correct command for your mode:

  # STDIO mode
  npx @modelcontextprotocol/inspector python main.py --mode stdio
  
  # HTTP mode (server must be running)
  python main.py --mode http
  # Then in another terminal:
  npx @modelcontextprotocol/inspector http://localhost:8003/mcp
  

• Check that all dependencies are installed: pip install -r requirements.txt
• Verify Python version is 3.8 or higher: python --version

No search results returned

Issue: search_feed returns empty results Solutions:

• Verify the feed name is correct (use list_feeds to see available feeds)
• Check your internet connection
• Some feeds may be temporarily unavailable - try again later
• Ensure your query isn't too specific; try broader search terms

ModuleNotFoundError when running

Issue: ModuleNotFoundError: No module named 'src' or similar Solutions:

• Make sure you're running from the project root directory
• Ensure the virtual environment is activated
• Reinstall dependencies: pip install -r requirements.txt

HTTP mode connection refused

Issue: Connection refused when connecting to HTTP server Solutions:

• Verify the server is running: python main.py --mode http
• Check the port isn't in use: lsof -i :8003 (Linux/Mac) or netstat -ano | findstr :8003 (Windows)
• Try a different port: python main.py --mode http --port 8004

Feed parsing errors

Issue: Errors parsing RSS feeds Solutions:

• Check your internet connection
• Some RSS feeds may have temporary issues - wait a few minutes and retry
• Verify the feed URL is accessible in a browser
• Check console output for specific error messages

Getting Help

If you encounter an issue not listed here:

1. Check existing GitHub Issues
2. Review the Contributing Guide for development setup details
3. Create a new issue with:
   • Clear description of the problem
   • Steps to reproduce
   • Error messages or logs
   • Your environment (OS, Python version)

🤝 Contributing

We welcome contributions! Whether you want to add a new feed source, fix a bug, or improve documentation, please check out our Contributing Guide.

Quick Contribution Ideas

• Add new RSS feed sources (Reddit, Hacker News, Dev.to, Medium, GitHub Trending, ArXiv, Stack Overflow, etc.)
• Implement feed caching for better performance
• Add result filtering and sorting options (by date, source, relevance)
• Create output formatting options (JSON, Markdown, HTML)
• Add more comprehensive tests and test coverage
• Improve documentation with examples and tutorials
• Add Docker support for easy deployment
• Implement rate limiting awareness for feeds
• Add result deduplication across multiple sources
• Create a CLI interface for standalone usage
• Add feed result pagination support
• Implement async/await support for concurrent searches
• Add support for private/authenticated feeds
• Create a web dashboard for feed management
• Add export functionality (CSV, PDF, etc.)

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Built with FastMCP
• Uses feedparser for RSS parsing
• MCP protocol by Anthropic

💬 Support

• Open an issue for bugs or feature requests
• Check existing issues for solutions
• Read the Contributing Guide for development setup

🔮 Roadmap

• [ ] Add caching layer for feed results
• [ ] Support for feed authentication
• [ ] More built-in feed sources
• [ ] Result deduplication across sources
• [ ] Advanced filtering options
• [ ] REST API mode
• [ ] Docker support

---

Happy searching! 🔍