🚀 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:

FIRST_TIME_SETUP.bat
START_SERVER.bat

Linux/Mac:

npm run setup
chmod +x start_server.sh
./start_server.sh

Manual Setup

1. Install dependencies:

npm install

2. Start server (with auto-update):

npm run auto-start

3. Or start without updates:

npm start

Server will be available at:

• MCP Endpoint: http://localhost:3000/mcp
• Health Check: http://localhost:3000/health

📋 Available Tools (26)

🔷 Basic Tools (6)

• 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

🔷 Advanced Analytics (5)

• 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

🔷 Content & Translation (3)

• rss_translate - AI-powered translation
• rss_media - Extract images and videos
• rss_full_content - Scrape full article content

🔷 Comparison & Verification (2)

• rss_compare - Compare feed coverage
• rss_cross_verify - Cross-source verification

🔷 Export & Reporting (3)

• rss_export - Export to JSON/CSV/XML
• rss_daily_digest - Generate daily/weekly reports
• rss_opml - OPML import/export

🔷 AI Features (3)

• rss_recommend - Feed recommendations
• rss_auto_categorize - Auto categorization
• rss_credibility_score - Reliability scoring

🔷 Management & Monitoring (4)

• 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

{
  "mcpServers": {
    "rss-mcp": {
      "command": "node",
      "args": [
        "node_modules/tsx/dist/cli.mjs",
        "src/index.ts"
      ],
      "cwd": "/path/to/RSS-MCP"
    }
  }
}

MCP Inspector (Testing)

npx @modelcontextprotocol/inspector
# Connect to: http://localhost:3000/mcp

💡 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

npm run dev              # Development mode (watch)
npm run dev:http         # HTTP transport development
npm run build            # TypeScript compilation
npm run clean            # Clean build artifacts
npm run update-deps      # Update dependencies

📦 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

RSS-MCP/
├── src/
│   ├── database/          # Database schema & repositories
│   ├── services/          # Business logic (22 services)
│   ├── tools/             # MCP tools (26 tools)
│   ├── utils/             # Utilities
│   └── index.ts           # MCP server
├── data/                  # SQLite database (auto-created)
├── START_SERVER.bat       # Auto-update launcher (Windows)
├── start_server.sh        # Auto-update launcher (Linux/Mac)
├── FIRST_TIME_SETUP.bat   # Initial setup script
└── package.json

🔒 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