🚀 RSS-MCP v3.0

Professional RSS Feed Management System with AI-Powered Analytics

Modern RSS/Atom feed aggregation and analysis tool built for Model Context Protocol (MCP), enabling AI assistants like Claude to manage and analyze news feeds with advanced features.

✨ Features

🎯 Core Features

• RSS Feed Management - Add, list, update, and delete RSS/Atom feeds

• Smart Search - Advanced filtering by keyword, category, date range

• Auto Updates - Automatic feed refresh with configurable scheduling

• SQLite Database - Persistent storage with optimized indexing

🤖 AI-Powered Analytics

• Sentiment Analysis - Detect positive/negative/neutral tone in articles

• Trend Detection - NLP-based topic clustering and trending keywords

• Auto-Categorization - Intelligent AI-based article classification

• Cross-Verification - Compare article coverage across multiple sources

🔔 Automation & Monitoring

• Webhook Notifications - Real-time alerts with keyword filtering

• Feed Scheduling - Cron-based automated updates

• Health Monitoring - Track feed uptime and performance

• Credibility Scoring - Assess feed reliability and quality

📊 Content & Export

• Daily Digest - Generate HTML/Markdown summary reports

• OPML Support - Import/export feed lists for easy migration

• Full Content Extraction - Web scraping for complete articles

• Multiple Export Formats - JSON, CSV, XML support

🚀 Quick Start

Automatic Setup (Recommended)

Windows:

Linux/Mac:

Manual Setup

1. Install dependencies:

2. Start server (with auto-update):

3. Or start without updates:

Server will be available at:

• MCP Endpoint: http://localhost:3000/mcp

• Health Check: http://localhost:3000/health

📋 Available Tools (26)

• rss_add - Add new RSS/Atom feed

• rss_list - List all feeds

• rss_update - Update feeds (fetch new articles)

• rss_news - Get articles from specific feed

• rss_search - Advanced article search

• rss_delete - Remove feed

• rss_breaking - Breaking news detection

• rss_duplicates - Find duplicate articles

• rss_analytics - Feed statistics and metrics

• rss_trends - Trending topics analysis (NLP)

• rss_sentiment_analysis - Emotional tone detection

• rss_translate - AI-powered translation

• rss_media - Extract images and videos

• rss_full_content - Scrape full article content

• rss_compare - Compare feed coverage

• rss_cross_verify - Cross-source verification

• rss_export - Export to JSON/CSV/XML

• rss_daily_digest - Generate daily/weekly reports

• rss_opml - OPML import/export

• rss_recommend - Feed recommendations

• rss_auto_categorize - Auto categorization

• rss_credibility_score - Reliability scoring

• rss_notification_setup - Webhook alerts

• rss_bookmark - Reading list management

• rss_schedule - Automated scheduling

• rss_health_monitor - Feed health tracking

🔌 MCP Client Integration

Claude Desktop

Add to your Claude Desktop config:

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

MCP Inspector (Testing)

💡 Usage Examples

With Claude

Add a feed:

"Add BBC News RSS feed: https://feeds.bbci.co.uk/news/rss.xml"

Analyze trends:

"Show me trending topics from the last 7 days"

Sentiment analysis:

"Analyze the sentiment of today's news"

Generate digest:

"Create a daily digest of top 10 articles in HTML format"

Schedule updates:

"Schedule BBC News to update every 6 hours"

🛠️ Development

📦 Tech Stack

• Runtime: Node.js 18+

• Language: TypeScript

• Database: SQLite (better-sqlite3)

• MCP SDK: @modelcontextprotocol/sdk

• NLP: natural, sentiment

• Web Scraping: cheerio

• Scheduling: cron-parser, node-cron

• Validation: Zod

🏗️ Project Structure

🔒 Security

• ✅ URL validation (HTTP/HTTPS only)

• ✅ Private IP blacklist

• ✅ MIME type validation

• ✅ Request timeout protection

• ✅ Domain-based rate limiting

• ✅ SQL injection protection (prepared statements)

📚 Documentation

• AUTO_UPDATE_GUIDE.md - Auto-update system guide

• MCP_CLIENT_GUIDE.md - MCP client setup

• CHANGELOG.md - Version history

• KURULUM_REHBERI.md - Installation guide (Turkish)

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository

2. Create your feature branch (git checkout -b feature/AmazingFeature)

3. Commit your changes (git commit -m 'Add some AmazingFeature')

4. Push to the branch (git push origin feature/AmazingFeature)

5. Open a Pull Request

📄 License

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

🙏 Acknowledgments

• Built with Model Context Protocol SDK

• Powered by Natural for NLP features

• Uses Cheerio for web scraping

📞 Support

• 🐛 Report Bug

• 💡 Request Feature

• 📖 Documentation

⭐ Star History

If you find this project useful, please consider giving it a star!

Made with ❤️ for the MCP community