MCP Reddit Digest

🚀 MCP Reddit 消息 digest 服務器

這是一個基於 FastAPI 的 MCP（模型上下文協議）服務器，它能自動抓取、總結 Reddit 內容，並直接將其傳遞到 Slack。該系統藉助 Azure OpenAI 為選定 subreddit 中的頂級帖子創建簡潔摘要，將其格式化為有組織的 PDF 報告，方便與團隊共享。

🚀 快速開始

先決條件

• 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

安裝

# 克隆倉庫
git clone https://github.com/yourusername/mcp-reddit-digest.git
cd mcp-reddit-digest

# 安裝依賴項
pip install -r requirements.txt

# 啟動服務器
uvicorn mcp_server.main:app --reload

✨ 主要特性

• 🔍 智能 Reddit 監控：按主題（人工智能、網絡安全、編程）抓取熱門帖子，或指定自定義 subreddit
• 🧠 AI 驅動摘要：使用 Azure OpenAI 壓縮冗長的 Reddit 討論
• 📝 整潔 Markdown 格式化：生成結構良好的 digest，按 subreddit 組織帖子
• 📄 專業的 PDF 報告：將 Markdown 轉換為帶自定義 CSS 的樣式 PDF
• 🔔 Slack 集成：自動將 digest 發送到您的團隊 Slack 通道
• ⏱️ 計劃交付：配置按日或自定義時間表的自動化 digest
• 🧩 模塊化架構：輕鬆擴展新功能或集成

💻 使用示例

基礎用法

API 端點

• GET / - 健康檢查端點
• POST /mcp/hello - 驗證連接性的測試端點
• POST /mcp/reddit - 生成按主題的 digest（ai、網絡安全、技術更新等）
• POST /mcp/reddit/subreddit - 生成自定義 subreddit 的 digest

高級用法

示例請求

按主題生成 digest：

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

為特定 subreddit 生成 digest：

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

🔧 技術細節

該服務器由以下組件組成：

• mcp_server：主 FastAPI 服務，處理 API 請求。
• digest_generator：負責抓取 Reddit 帖子、生成摘要和格式化輸出的模塊。
• config：包含環境變量和配置設置的文件。
• models：定義數據模型和數據庫結構的目錄。
• templates：用於生成 PDF 報告的模板文件。

通過以上步驟，您可以輕鬆部署並運行一個 MCP Reddit 消息 digest 服務器，自動化處理 Reddit 內容並將其傳遞到 Slack 團隊中。