MCP Reddit

🚀 MCP Reddit 服務器

本項目是一個基於MCP（模型上下文協議）協議的Reddit服務器，專為與Claude等大語言模型交互而設計。藉助該服務，你能讓AI助手幫你瀏覽和分析Reddit上的內容。

🚀 快速開始

克隆倉庫

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

安裝依賴

pip install -r requirements.txt

運行服務器

python src/server.py

✨ 主要特性

• 搜索特定subreddit中的帖子
• 獲取帖子詳細信息和評論
• 瀏覽subreddit中的熱門帖子

📦 安裝指南

前提條件

• Docker（必須）
• Python 3.12+（用於本地開發）
• Reddit API憑證（必需）

獲取Reddit API憑證

1. 訪問 https://www.reddit.com/prefs/apps
2. 點擊"create another app..."
3. 選擇"script"
4. 填寫必要信息
5. 獲取client_id和client_secret

環境變量配置

需要設置以下環境變量：

REDDIT_CLIENT_ID=你的client_id
REDDIT_CLIENT_SECRET=你的client_secret
REDDIT_USER_AGENT=你的user_agent

Docker安裝說明

1. 克隆倉庫：

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

2. 安裝依賴：

   pip install -r requirements.txt
   

3. 構建Docker鏡像：

   docker build -t mcp-reddit .
   

4. 運行容器：

   docker run -i --rm \
     -e REDDIT_CLIENT_ID=你的client_id \
     -e REDDIT_CLIENT_SECRET=你的client_secret \
     -e REDDIT_USER_AGENT=你的user_agent \
     mcp-reddit
   

📚 詳細文檔

項目結構

nangeAGICode/reddit_chat_claude/
├── .github/
│   └── workflows/
│       └── docker.yml # GitHub Actions工作流配置
├── src/
│   ├── init.py
│   └── server.py # MCP服務器核心代碼
├── .gitignore # Git忽略文件配置
├── Dockerfile # Docker構建文件
├── LICENSE # MIT許可證
├── README.md # 項目說明文檔
└── requirements.txt # Python依賴包列表

📄 許可證

本項目採用 MIT 許可證 - 查看 LICENSE 文件瞭解詳情

⚠️ 注意事項

安全性

• 請妥善保管你的Reddit API憑證
• 不要在公共場合分享你的配置文件
• 建議使用環境變量而不是硬編碼憑證

使用限制

• Reddit API有調用頻率限制
• 默認返回的評論數量限制為10條
• 搜索結果默認限制為5條

故障排除

• 檢查API憑證是否正確
• 確保網絡連接正常
• 查看日誌輸出瞭解詳細錯誤信息

🤝 貢獻指南

1. Fork 項目
2. 創建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 開啟 Pull Request