MCP Reddit Digest Server

MCP Reddit Digest Server

一个基于 FastAPI 的 MCP（Model Context Protocol）服务，可自动获取 Reddit 内容、生成摘要并直接发送到 Slack。该系统使用 Azure OpenAI 为选定 subreddit 的热门帖子生成简明摘要，将其整理成结构清晰的 PDF 报告，并分享给团队。

✨ 功能

• 🔍 智能 Reddit 监控：按主题（AI、网络安全、编程）获取热门帖子，或指定自定义 subreddit
• 🧠 AI 驱动的摘要：使用 Azure OpenAI 浓缩冗长的 Reddit 讨论
• 📝 清晰的 Markdown 排版：生成结构良好的摘要，并按 subreddit 整理帖子
• 📄 专业 PDF 报告：使用自定义 CSS 将 Markdown 转换为样式精美的 PDF
• 🔔 Slack 集成：自动将摘要发送到团队的 Slack 频道
• ⏱️ 定时发送：配置每日或自定义计划，自动发送摘要
• 🧩 模块化架构：轻松扩展新功能或集成

MCPHub 认证：Reddit Digest - omendra02 MCP Server

前置条件

• Python 3.8+
• Reddit API 凭据
• Azure OpenAI API 访问权限
• 配置了机器人集成的 Slack 工作区

环境设置

在项目根目录中创建 .env 文件，并添加以下变量：

# 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

安装

# 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

🔧 使用方法

API 端点

• GET / - 健康检查端点
• POST /mcp/hello - 用于验证连接的测试端点
• POST /mcp/reddit - 按主题（ai、cybersecurity、tech update 等）生成摘要
• POST /mcp/reddit/subreddit - 根据自定义 subreddit 生成摘要

请求示例

按主题生成摘要：

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

为指定 subreddit 生成摘要：

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

⚙️ 配置

定时摘要

系统已配置为定时生成摘要。编辑 scheduler.py 以调整时间：

# For production (runs daily at 9 AM)
scheduler.add_job(scheduled_reddit_digest, 'cron', hour=9, minute=0)

# For testing (runs every minute)
scheduler.add_job(scheduled_reddit_digest, 'interval', minutes=1)

主题映射

默认的主题到 subreddit 映射定义在 reddit_fetcher.py 中。可根据需要添加或修改映射：

TOPIC_SUBREDDITS = {
    "tech update": ["technology", "technews", "IndiaTech", "developersIndia"],
    "ai": ["MachineLearning", "ArtificialIntelligence", "Singularity", "artificial"],
    # Add new mappings here
}

🔄 项目结构

mcp_server/
├── core/
│   ├── slack_notifiers.py    # Slack integration
│   ├── summarizer.py         # Azure OpenAI integration
│   └── utils.py              # Helper functions
├── tools/
│   ├── hello_tool.py         # Simple test tool
│   └── reddit_digest/        # Reddit digest functionality
│       ├── markdown_generator.py
│       ├── pdf_generator.py
│       ├── reddit_fetcher.py
│       ├── style.css         # PDF styling
│       └── tool.py           # Main digest logic
├── main.py                   # FastAPI application
├── mcp.json                  # Tool definitions
└── scheduler.py              # Automated tasks