Reddit Buddy MCP

🚀 Reddit MCP Buddy

Reddit MCP Buddy是一款專為Claude Desktop和其他AI助手打造的Reddit瀏覽器。它基於模型上下文協議（MCP），能讓AI助手瀏覽Reddit、搜索帖子並分析用戶活動。無需API密鑰，使用便捷、響應快速且數據真實可靠。

🚀 快速開始

針對Claude Desktop

在你的claude_desktop_config.json文件中添加以下內容：

{
  "mcpServers": {
    "reddit": {
      "command": "npx",
      "args": ["reddit-mcp-buddy"]
    }
  }
}

大功告成！現在Reddit MCP Buddy已可在Claude中使用。

✨ 主要特性

• 🚀 零配置 - 即開即用，無需註冊Reddit API。
• ⚡ 多達10倍的請求量 - 可選的身份驗證可提高請求速率限制。
• 🎯 純淨數據 - 不提供虛假的“情感分析”或編造的指標。
• 🧠 專為大語言模型優化 - 專門為Claude等AI助手設計。
• 📦 TypeScript編寫 - 完全類型化，可靠且易於維護。

📦 安裝指南

交互式身份驗證設置（僅用於本地測試）

對於本地開發和測試，你可以交互式地設置身份驗證：

npx reddit-buddy --auth

這將提示你輸入Reddit應用憑證並將其保存到本地。注意：此方法不適用於Claude Desktop - 請在Claude配置中使用環境變量。

HTTP模式測試

要在終端中直接測試服務器：

# 在端口3000上以HTTP模式運行
npx reddit-mcp-buddy --http

# 或使用自定義端口
REDDIT_BUDDY_PORT=8080 npx reddit-mcp-buddy --http

注意：服務器默認以stdio模式運行（適用於Claude Desktop）。使用--http標誌可通過Postman MCP或直接API調用進行測試。

全局安裝

npm install -g reddit-mcp-buddy
reddit-buddy --http  # 用於測試

從源代碼安裝

git clone https://github.com/karanb192/reddit-mcp-buddy.git
cd reddit-mcp-buddy
npm install
npm run build
npm link

使用Docker

docker run -it karanb192/reddit-mcp-buddy

💻 使用示例

你的AI現在可以回答以下問題：

"今天關於GPT - 4的熱門帖子有哪些？"

→ search_reddit with query="GPT-4", time="day", sort="top"

"給我展示科技領域的熱門趨勢"

→ browse_subreddit with subreddit="technology", sort="hot"

"人們對這篇文章有什麼看法？"

→ search_reddit with the article URL to find discussions

"分析用戶DeepFuckingValue"

→ user_analysis with username="DeepFuckingValue"

"獲取這篇Reddit帖子的評論"

→ get_post_details with url="https://reddit.com/r/..."

"整個Reddit上的熱門內容有哪些？"

→ browse_subreddit with subreddit="all", sort="hot"

📚 詳細文檔

它能做什麼？

你可以讓你的AI助手執行以下操作：

• 📊 "Reddit上正在流行什麼？" - 瀏覽r/all中的熱門帖子。
• 🔍 "搜索關於AI的討論" - 在所有子版塊中進行搜索。
• 💬 "獲取這篇Reddit帖子的評論" - 獲取帶有完整評論線程的帖子。
• 👤 "分析用戶spez" - 獲取用戶歷史、積分和活動信息。
• 📚 "解釋Reddit積分" - 瞭解Reddit術語。

可用工具

browse_subreddit

可按排序選項瀏覽任何子版塊的帖子。

- 子版塊：
  - "all" - 整個Reddit首頁
  - "popular" - Reddit上的熱門內容
  - 任何特定的子版塊（例如，"technology"、"programming"、"science"）
- 排序方式：熱門、最新、置頂、上升、有爭議
- 時間範圍：小時、天、周、月、年、全部（適用於置頂/有爭議的排序）
- 包含子版塊信息：可選標誌，用於獲取子版塊元數據

search_reddit

可在Reddit或特定子版塊中進行搜索。

- 查詢：你的搜索詞
- 過濾條件：子版塊、作者、時間、標籤
- 排序方式：相關性、熱門、置頂、最新、評論數

get_post_details

獲取帶有所有評論的帖子。

- 輸入：
  - Reddit URL（包括子版塊的完整URL），或
  - 僅帖子ID（將自動檢測子版塊，需2次API調用），或
  - 帖子ID + 子版塊（最有效，需1次API調用）
- 選項：評論排序、深度、鏈接提取

user_analysis

分析Reddit用戶的個人資料。

- 用戶名：任何Reddit用戶
- 返回：積分、帖子、評論、活躍子版塊

reddit_explain

獲取Reddit術語的解釋。

- 術語：積分、蛋糕日、AMA、ELI5等

身份驗證（可選）

如果你需要更多的請求量，可以在Claude Desktop配置中添加Reddit憑證：

設置步驟

1. 訪問https://www.reddit.com/prefs/apps
2. 創建一個應用（類型：腳本 - 重要！）
3. 找到你的憑證：
   • 客戶端ID：顯示在“個人使用腳本”下方
   • 客戶端密鑰：應用頁面上的密鑰字符串
4. 更新你的Claude Desktop配置：

{
  "mcpServers": {
    "reddit": {
      "command": "npx",
      "args": ["reddit-mcp-buddy"],
      "env": {
        "REDDIT_CLIENT_ID": "your_client_id",
        "REDDIT_CLIENT_SECRET": "your_client_secret",
        "REDDIT_USERNAME": "your_username",
        "REDDIT_PASSWORD": "your_password"
      }
    }
  }
}

速率限制

• 無身份驗證：每分鐘10個請求（默認）
• 僅客戶端ID + 密鑰：每分鐘60個請求
• 包含用戶名 + 密碼：每分鐘100個請求

注意：要達到最大速率限制（每分鐘100個請求），你需要包括用戶名和密碼在內的所有四個憑證。

與其他工具的比較

速率限制

為什麼選擇Reddit MCP Buddy？

其他工具的不足之處：

• ❌ 虛假指標 - “情感評分”只是簡單的關鍵詞計數。
• ❌ 複雜的設置 - 僅啟動就需要API密鑰。
• ❌ 臃腫的響應 - 返回Reddit原始API的100多個字段。
• ❌ 大語言模型集成不佳 - 參數混亂且描述不清晰。

我們的優勢：

• ✅ 僅真實數據 - 如果不是來自Reddit API，我們不會編造。
• ✅ 簡潔的響應 - 只返回重要的字段。
• ✅ 清晰的參數 - 大語言模型能準確理解要發送的內容。
• ✅ 快速且有緩存 - 儘可能即時響應。

故障排除

常見問題

“命令未找到”錯誤

# 確保npm已安裝
node --version
npm --version

# 嘗試使用完整的npx路徑
$(npm bin -g)/reddit-mcp-buddy

速率限制錯誤

• 無身份驗證：每分鐘限制10個請求。
• 僅應用憑證：每分鐘60個請求。
• 完整身份驗證：每分鐘100個請求。
• 解決方案：添加Reddit憑證（見身份驗證）。

“未找到子版塊”

• 檢查拼寫（不區分大小寫）。
• 某些子版塊可能是私有的或被隔離的。
• 嘗試使用“all”或“popular”代替。

連接問題

• Reddit可能已宕機（檢查https://www.redditstatus.com）。
• 防火牆可能阻止了請求。
• 嘗試重啟MCP服務器。

環境變量

身份驗證變量

服務器配置

🔧 技術細節

智能緩存系統

Reddit MCP Buddy包含智能緩存系統，以提高性能並減少API調用：

• 內存安全：硬限制為50MB - 不會影響你的系統性能。
• 自適應TTL：熱門帖子（5分鐘）、新帖子（2分鐘）、置頂帖子（30分鐘）。
• LRU淘汰機制：在接近限制時自動移除最少使用的數據。
• 命中跟蹤：根據實際使用模式優化緩存。 這意味著更快的響應速度，並能在使用最少系統資源的情況下，嚴格遵守Reddit的速率限制。

開發

# 安裝依賴
npm install

# 開發模式運行
npm run dev

# 構建
npm run build

# 測試
npm test

# 代碼檢查
npm run lint

# 類型檢查
npm run typecheck

要求

• Node.js >= 18.0.0
• npm或yarn
• TypeScript 5.5+

貢獻

歡迎提交PR！請參閱CONTRIBUTING.md獲取指南。 我們保持簡單：

• 無虛假分析。
• 代碼簡潔、類型化。
• 文檔清晰。
• 響應快速。

支持

• 🐛 報告漏洞
• 💡 請求功能
• ⭐ 在GitHub上給項目加星

📄 許可證

本項目採用MIT許可證，你可以隨意使用！

為MCP社區用心打造。無風險投資，無跟蹤，只是一個優秀的MCP服務器。