imachiever/reddit-ai

RedditAI - MCP Server

A powerful Model Context Protocol (MCP) server that provides seamless Reddit integration for Claude Desktop and Cursor AI. This server enables AI assistants to search Reddit, analyze posts, track trends, and gather insights from the Reddit community.

🚀 Features

• Reddit Search: Search across all of Reddit or specific subreddits
• Subreddit Analysis: Get trending posts and analyze community sentiment
• Post Details: Retrieve comprehensive post information with comments
• User Profiles: Get detailed user statistics and karma information
• Trending Discovery: Find popular and rising subreddits
• Sentiment Analysis: Analyze community mood and post sentiment
• Real-time Data: Access current Reddit data without authentication

🛠️ Installation

Prerequisites

• Node.js 18+
• npm or yarn

Setup

1. Clone or download this repository
2. Install dependencies:

   npm install
   

3. Start the server:

   npm start
   

🔧 Configuration

Claude Desktop

1. Open Claude Desktop
2. Go to Settings → MCP Servers
3. Add a new server with these settings:
   • Name: Reddit Integration
   • Command: node
   • Arguments: [path-to-your-project]/reddit-ai-mcp.js
   • Working Directory: [path-to-your-project]

Cursor AI

1. Open Cursor AI
2. Go to Settings → Tools & Integrations → New MCP Server
3. Add the server configuration similar to Claude Desktop

📚 Available Tools

1. search_reddit

Search Reddit posts and comments across all subreddits or within a specific one.

Parameters:

• query (required): Search term
• subreddit (optional): Limit search to specific subreddit
• sort: relevance, hot, top, new, comments
• time_filter: hour, day, week, month, year, all
• limit: Number of results (max 100)

Example:

Search for "AI tools" in r/artificial with top posts from this week

2. get_subreddit_posts

Get posts from a specific subreddit with various sorting options.

Parameters:

• subreddit (required): Subreddit name
• sort: hot, new, rising, top
• time_filter: hour, day, week, month, year, all
• limit: Number of posts (max 100)

Example:

Get the top 25 posts from r/technology this month

3. get_post_details

Retrieve detailed information about a specific Reddit post.

Parameters:

• post_id (required): Reddit post ID
• include_comments: Include top comments
• comment_limit: Max comments to fetch (max 50)

Example:

Get details for post "abc123" with top 10 comments

4. get_user_profile

Get comprehensive user profile information and statistics.

Parameters:

• username (required): Reddit username

Example:

Get profile for user "spez"

5. get_trending_subreddits

Discover popular and trending subreddits.

Parameters:

• limit: Number of subreddits (max 50)

Example:

Get 25 trending subreddits

6. analyze_sentiment

Analyze sentiment of posts in a subreddit.

Parameters:

• subreddit (required): Subreddit to analyze
• query (optional): Specific topic to analyze
• sample_size: Number of posts to analyze (max 100)

Example:

Analyze sentiment in r/worldnews about "climate change"

💡 Use Cases

For Content Creators

• Trend Research: Find trending topics and viral content
• Community Analysis: Understand what resonates with specific audiences
• Content Inspiration: Discover popular discussions and questions
• Competitor Research: Monitor relevant subreddits and posts

For Marketers & Researchers

• Brand Monitoring: Track mentions and sentiment about products/services
• Market Research: Understand customer pain points and preferences
• Trend Analysis: Identify emerging topics and conversations
• Community Insights: Analyze subreddit demographics and engagement

For Developers

• API Research: Find popular tools and libraries discussed
• Bug Reports: Discover common issues and solutions
• Feature Requests: Understand what users want from tools
• Community Building: Identify where to engage with target users

For Journalists & Analysts

• Breaking News: Track real-time discussions and reactions
• Public Opinion: Gauge community sentiment on current events
• Source Discovery: Find eyewitness accounts and primary sources
• Trend Tracking: Monitor how stories evolve over time

For Educators

• Current Events: Bring real-world examples into lessons
• Student Engagement: Use trending topics to spark discussions
• Research Projects: Help students analyze online communities
• Digital Literacy: Teach students about online discourse

For Personal Use

• Hobby Discovery: Find communities for new interests
• Product Research: Get honest reviews and recommendations
• Learning Resources: Discover educational content and discussions
• Entertainment: Find funny, interesting, or inspiring content

🔒 Privacy & Ethics

• No Authentication Required: Uses public Reddit data only
• Rate Limiting: Respects Reddit's API limits
• Data Minimization: Only fetches necessary information
• User Privacy: Respects user privacy and Reddit's terms of service

🚨 Limitations

• Public Data Only: Cannot access private subreddits or deleted content
• Rate Limits: Subject to Reddit's API restrictions
• Historical Data: Limited to currently available posts
• Sentiment Analysis: Basic keyword-based analysis (not ML-powered)

🛠️ Development

Running in Development Mode

npm run dev

Project Structure

reddit-ai/
├── reddit-ai-mcp.js       # Main server implementation
├── package.json            # Dependencies and scripts
└── README.md              # This file

Adding New Tools

To add new Reddit functionality:

1. Define the tool schema in setupToolHandlers()
2. Add the case handler in the CallToolRequestSchema handler
3. Implement the method in the class
4. Update this README with the new tool

🤝 Contributing

Contributions are welcome! Please feel free to submit issues, feature requests, or pull requests.

📄 License

MIT License - see LICENSE file for details.

🙏 Acknowledgments

• Built with the Model Context Protocol
• Uses Reddit's public JSON API
• Inspired by the need for better AI-Reddit integration

📞 Support

If you encounter issues or have questions:

1. Check the MCP documentation
2. Review Reddit's API terms
3. Open an issue in this repository

Happy Reddit exploring with AI! 🚀