MCP Reddit Digest

🚀 MCP Reddit Message Digest Server

This is a FastAPI-based MCP (Model Context Protocol) server that can automatically scrape, summarize, and directly deliver Reddit content to Slack. The system uses Azure OpenAI to create concise summaries of top posts from selected subreddits, formats them into organized PDF reports, and shares them with your team.

✨ Features

• 🔍 Intelligent Reddit Monitoring: Scrape popular posts by topic (AI, Cybersecurity, Programming) or specify custom subreddits.
• 🧠 AI-Driven Summarization: Use Azure OpenAI to condense lengthy Reddit discussions.
• 📝 Neat Markdown Formatting: Generate well-structured digests, organizing posts by subreddit.
• 📄 Professional PDF Reports: Convert Markdown to styled PDFs with custom CSS.
• 🔔 Slack Integration: Automatically send digests to your team's Slack channels.
• ⏱️ Scheduled Delivery: Configure automated digests on a daily or custom schedule.
• 🧩 Modular Architecture: Easily extend with new features or integrations.

🚀 Quick Start

Prerequisites

• Python 3.8+
• Reddit API credentials
• Azure OpenAI API access
• A Slack workspace with bot integration

Environment Setup

Create a .env file in the project root directory with the following variables:

# Reddit API
REDDIT_CLIENT_ID=your_client_id
REDDIT_CLIENT_SECRET=your_client_secret
REDDIT_USERNAME=your_username
REDDIT_PASSWORD=your_password
USER_AGENT=your_user_agent

# Azure OpenAI
AZURE_OPENAI_KEY=your_openai_key
AZURE_OPENAI_API_VERSION=your_api_version
AZURE_OPENAI_ENDPOINT=your_endpoint
AZURE_OPENAI_DEPLOYMENT=your_deployment_name

# Slack
SLACK_BOT_TOKEN=your_slack_bot_token
SLACK_CHANNEL_ID=your_channel_id

📦 Installation

# Clone the repository
git clone https://github.com/yourusername/mcp-reddit-digest.git
cd mcp-reddit-digest

# Install dependencies
pip install -r requirements.txt

# Start the server
uvicorn mcp_server.main:app --reload

💻 Usage Examples

API Endpoints

• GET / - Health check endpoint
• POST /mcp/hello - Test endpoint to verify connectivity
• POST /mcp/reddit - Generate a topic-based digest (AI, Cybersecurity, Tech Updates, etc.)
• POST /mcp/reddit/subreddit - Generate a digest for a custom subreddit

Basic Usage

Generate a topic-based digest:

curl -X POST "http://localhost:8000/mcp/reddit" \
  -H "Content-Type: application/json" \
  -d '{"input": "ai"}'

Generate a digest for a specific subreddit:

curl -X POST "http://localhost:8000/mcp/reddit/subreddit" \
  -H "Content-Type: application/json" \
  -d '{"input": "technology"}'

🔧 Technical Details

The server consists of the following components:

• mcp_server: The main FastAPI service that handles API requests.
• digest_generator: A module responsible for scraping Reddit posts, generating summaries, and formatting outputs.
• config: Files containing environment variables and configuration settings.
• models: A directory defining data models and database structures.
• templates: Template files for generating PDF reports.

By following the above steps, you can easily deploy and run an MCP Reddit message digest server to automate the processing of Reddit content and deliver it to your Slack team.