Reddit MCP

🚀 Reddit MCP 服務器

本倉庫包含一個適用於 Reddit 的模型上下文協議（MCP）服務器實現，它允許 AI 助手通過 PRAW（Python Reddit API 包裝器）訪問 Reddit 內容並與之交互。

🚀 快速開始

Reddit MCP 服務器藉助 MCP 協議，讓 AI 助手能與 Reddit 內容進行交互。以下是使用該服務器的快速指南。

安裝步驟

1. 克隆倉庫

git clone https://github.com/Arindam200/reddit-mcp.git
cd reddit-mcp

2. 連接到 MCP 服務器 複製以下 JSON 文件，並填入合適的 {{PATH}} 值：

{
    "mcpServers": {
        "reddit": {
            "command": "{{PATH_TO_UV}}", // 運行 `which uv` 並將輸出結果放在此處
            "args": [
                "--directory",
                "{{PATH_TO_SRC}}", // 進入倉庫目錄，運行 `pwd` 並將輸出結果填入此處
                "run",
                "server.py"
            ],
            "env": {
                "REDDIT_CLIENT_ID": "your_client_id",
                "REDDIT_CLIENT_SECRET": "your_client_secret",
                "REDDIT_USERNAME": "your_username", // 進行認證操作時可選
                "REDDIT_PASSWORD": "your_password" // 進行認證操作時可選
            }
        }
    }
}

你可以在 Reddit 的應用偏好設置頁面 創建應用來獲取 Reddit API 憑證。 對於 Claude，將此文件保存為 claude_desktop_config.json，路徑為：

~/Library/Application Support/Claude/claude_desktop_config.json

對於 Cursor，將此文件保存為 mcp.json，路徑為：

~/.cursor/mcp.json

3. 重啟 Claude Desktop / Cursor 打開 Claude Desktop，此時你應該能看到 Reddit 已作為可用集成選項。或者重啟 Cursor。

可用工具

服務器提供以下工具：

只讀工具（僅需客戶端憑證）

• get_user_info(username) - 獲取詳細的用戶分析及參與度洞察
• get_top_posts(subreddit, time_filter, limit) - 獲取並分析熱門帖子
• get_subreddit_stats(subreddit) - 獲取全面的子版塊分析
• get_trending_subreddits() - 獲取熱門子版塊列表
• get_submission_by_url(url) - 通過 URL 獲取 Reddit 帖子
• get_submission_by_id(submission_id) - 通過 ID 獲取 Reddit 帖子

認證工具（需要用戶憑證）

• who_am_i() - 獲取當前認證用戶的信息
• create_post(subreddit, title, content, flair, is_self) - 創建優化後的帖子
• reply_to_post(post_id, content, subreddit) - 添加具有參與度洞察的回覆
• reply_to_comment(comment_id, content, subreddit) - 添加策略性回覆

示例查詢

以下是一些你可以向連接到該服務器的 AI 助手提出的問題示例：

• “我在 Reddit 上是誰？” 或 “顯示我的 Reddit 個人資料”
• “分析 u/spez 的 Reddit 活動”
• “顯示本週 r/Python 中的熱門帖子”
• “獲取 r/AskReddit 的統計信息”
• “當前有哪些熱門子版塊？”
• “在 r/Python 中發佈一篇關於新項目的帖子”
• “用有見解的評論回覆此帖子”
• “在這個子版塊發佈帖子的最佳時間是什麼時候？”

✨ 主要特性

• 獲取詳細的用戶信息並進行參與度分析
• 從任何子版塊獲取並分析熱門帖子
• 獲取全面的子版塊統計信息和健康指標
• 查看具有增長模式的熱門子版塊
• 根據時機建議創建策略性帖子
• 以優化參與度的方式回覆帖子和評論
• 提供 AI 驅動的洞察和建議
• 根據參與度指標進行智能回覆格式化

🔧 技術細節

AI 驅動分析

服務器在多個方面提供智能分析：

1. 用戶分析
   • 參與模式
   • 活動趨勢
   • 社區影響力
   • 個性化推薦
2. 帖子分析
   • 性能指標
   • 參與質量
   • 時機優化
   • 內容影響評估
3. 社區分析
   • 健康指標
   • 增長模式
   • 活動指標
   • 參與機會

智能回覆格式化

• 有條理的要點列表
• 參與度統計信息
• AI 驅動的洞察
• 策略性建議
• 性能指標

認證機制

服務器支持兩級認證：

1. 只讀訪問
   • 要求：client_id 和 client_secret
   • 權限：獲取公共數據、閱讀帖子/評論
2. 認證訪問
   • 要求：所有隻讀憑證加上 username 和 password
   • 權限：所有隻讀操作加上發佈帖子和評論

📄 許可證

本項目採用 MIT 許可證，詳情請參閱 LICENSE 文件。

貢獻說明

歡迎貢獻代碼！請隨時提交拉取請求。