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 文件。

贡献说明

欢迎贡献代码！请随时提交拉取请求。