Reddit Mcp Server

Reddit MCP 服务

此仓库包含一个 Reddit 的模型上下文协议服务实现，可通过 PRAW（Python Reddit API Wrapper）让 AI 助手访问并与 Reddit 内容交互。

什么是 MCP？

模型上下文协议（MCP）是一种标准，用于让 AI 助手与外部服务、工具和数据源交互。此服务实现了 MCP 规范，以提供对 Reddit 内容的访问。

若想进一步了解 MCP，请观看此视频

功能

• 获取详细的用户信息并分析互动情况
• 灵活筛选并获取用户评论和帖子历史记录
• 获取并分析任意 subreddit 的热门帖子
• 使用搜索词在整个 Reddit 或特定 subreddit 中搜索帖子
• 获取全面的 subreddit 统计数据和健康指标
• 查看呈现增长趋势的热门 subreddit
• 根据发布时间建议创建有策略的帖子
• 通过优化互动效果来回复帖子和评论
• AI 驱动的洞察和建议
• 根据互动指标智能格式化回复

安装

1. 克隆此仓库

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

2. 连接到 MCP 服务

   将以下 JSON 中的 {{PATH}} 替换为相应的路径：

   {
     "mcpServers": {
       "reddit": {
         "command": "{{PATH_TO_UV}}", // Run `which uv` and place the output here
         "args": [
           "--directory",
           "{{PATH_TO_SRC}}", // cd into the repo, run `pwd` and enter the output here
           "run",
           "server.py"
         ],
         "env": {
           "REDDIT_CLIENT_ID": "your_client_id",
           "REDDIT_CLIENT_SECRET": "your_client_secret",
           "REDDIT_USERNAME": "your_username", // Optional for authenticated operations
           "REDDIT_PASSWORD": "your_password" // Optional for authenticated operations
         }
       }
     }
   }
   

   在 Reddit 的应用偏好设置页面创建应用，即可获取 Reddit API 凭据。

   对于 Claude，将其保存为 claude_desktop_config.json，并放在 Claude Desktop 配置目录中：

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

   对于 Cursor，将其保存为 mcp.json，并放在 Cursor 配置目录中：

   ~/.cursor/mcp.json
   

3. 重启 Claude Desktop / Cursor

   打开 Claude Desktop，即可看到 Reddit 作为可用集成。

   或者重启 Cursor。

可用工具

此服务提供以下工具：

只读工具（仅需客户端凭据）：

• get_user_info(username) - 获取详细的用户分析和互动洞察
• get_user_comments(username, sort, time_filter, limit) - 获取用户评论历史记录，并提供筛选选项
• get_user_posts(username, sort, time_filter, limit) - 获取用户帖子／提交内容历史记录，并提供筛选选项
• get_top_posts(subreddit, time_filter, limit) - 获取并分析热门帖子
• search_posts(query, subreddit, sort, time_filter, limit) - 在 Reddit 或特定 subreddit 中搜索帖子
• get_subreddit_stats(subreddit) - 全面分析 subreddit
• get_trending_subreddits() - 获取热门 subreddit 列表
• 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 活动”
• “显示 u/spez 最近的评论”
• “获取 u/poem_for_your_sprog 过去一年的热门帖子”
• “显示 u/username 最具争议的评论”
• “显示本周 r/Python 的热门帖子”
• “搜索整个 Reddit 中关于‘machine learning’的帖子”
• “查找本月 r/learnprogramming 中关于‘beginner tutorials’的帖子”
• “获取 r/AskReddit 的统计数据”
• “现在有哪些正在流行的 subreddit？”
• “在 r/Python 发布一篇关于新项目的帖子”
• “针对这篇帖子回复一条有见地的评论”
• “在这个 subreddit 的最佳发帖时间是什么时候？”

高级功能

AI 驱动的分析

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

1. 用户分析

   • 互动模式
   • 活动趋势
   • 社区影响力
   • 个性化建议

2. 帖子分析

   • 表现指标
   • 互动质量
   • 时间优化
   • 内容影响评估

3. 社区分析

   • 健康指标
   • 增长模式
   • 活动指标
   • 互动机会

智能回复格式

• 有条理的项目符号列表
• 互动统计数据
• AI 驱动的洞察
• 策略建议
• 表现指标

身份验证

该服务支持两种级别的身份验证：

1. 只读访问

   • 需要：client_id 和 client_secret
   • 允许：获取公开数据、读取帖子和评论

2. 已验证访问

   • 需要：所有只读凭据，外加 username 和 password
   • 允许：所有只读操作，外加发帖和评论

参与贡献

欢迎参与贡献！请随时提交 Pull Request。

许可证

本项目采用 MIT License 授权，详情请参阅 LICENSE 文件。