JinDaGe - reddit-mcp MCP Details

article

README

🚀 Reddit MCP 服务器

本仓库包含一个适用于 Reddit 的模型上下文协议（MCP）服务器实现，它允许 AI 助手通过 PRAW（Python Reddit API 包装器）访问 Reddit 内容并与之交互。

🚀 快速开始

Reddit MCP 服务器借助 MCP 协议，让 AI 助手能与 Reddit 内容进行交互。以下是使用该服务器的快速指南。

安装步骤

克隆仓库

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

连接到 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

重启 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 驱动分析

服务器在多个方面提供智能分析：

用户分析
- 参与模式
- 活动趋势
- 社区影响力
- 个性化推荐
帖子分析
- 性能指标
- 参与质量
- 时机优化
- 内容影响评估
社区分析
- 健康指标
- 增长模式
- 活动指标
- 参与机会

智能回复格式化

有条理的要点列表
参与度统计信息
AI 驱动的洞察
策略性建议
性能指标

认证机制

服务器支持两级认证：

只读访问
- 要求：client_id 和 client_secret
- 权限：获取公共数据、阅读帖子/评论
认证访问
- 要求：所有只读凭证加上 username 和 password
- 权限：所有只读操作加上发布帖子和评论

📄 许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。

贡献说明

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

reddit-mcp