Reddit MCP服务器

一个允许Claude Desktop实时浏览、搜索和分析Reddit的模型上下文协议(MCP)服务器。

  • by hereisSwapnil
  • Python
  • 混合部署
  • 8 星标
  • 更新于
在 GitHub 查看 hereisSwapnil/reddit-mcp

使用说明

Reddit MCP

A Model Context Protocol (MCP) server that lets Claude Desktop browse, search, and analyze Reddit in real time.


✨ 什么是Reddit MCP?

Reddit MCP 是一个即插即用的MCP服务器,允许Claude Desktop直接与Reddit交互。

您的AI可以:

  • 浏览子版块
  • 搜索讨论和意见
  • 获取完整评论线程
  • 分析Reddit用户
  • 实时检测趋势和情绪

不要刮。没有设置摩擦。立即工作。


🎬 快速演示

https://github.com/user-attachments/assets/7cccd617-12f1-4ffc-966f-34415adb5dd6

💡 问克劳德:“今天r/编程的趋势是什么?”


🚀 快速启动(30秒)

  1. 安装 uv 如果你没有:

    macOS/Linux

    curl -LsSf https://astral.sh/uv/install.sh | sh
    sudo ln -sf ~/.local/bin/uv /usr/local/bin/uv
    

    视窗

    powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
    
  2. 下载MCP捆绑包
    👉 reddit-mcp.mcpb

  3. 双击 这 .mcpb 文件——Claude Desktop会自动安装它。

  4. 打开克劳德桌面 并开始向Reddit提问。

就是这样!


🔥 主要特点

特性 描述
🔍 浏览子文件夹 查看来自任何子版块的帖子,按热门、新、热门或升序排序
🔎 搜索Reddit 在全球或特定社区内搜索
📄 帖子详细信息 获取带有深度线程评论的完整帖子内容
👤 用户分析 分析Reddit用户的业力、活动模式和顶级子版块
🔓 匿名模式 不需要API密钥。开箱即用
⚡ 可选OAuth 添加Reddit凭据以获得更高的速率限制和稳定性

📦 一键安装(推荐)

直接在Claude Desktop中下载并安装:

支持: macOS•Windows•Linux


🛠️ 手动安装

将服务器添加到 claude_desktop_config.json:

{
  "mcpServers": {
    "reddit-mcp": {
      "command": "/usr/local/bin/uv",
      "args": ["run", "main.py"],
      "cwd": "/path/to/reddit-mcp"
    }
  }
}

保存后重新启动Claude Desktop。


🤖 ChatGPT集成

使用公共SSE端点将Reddit MCP连接到ChatGPT。

使用托管服务器(推荐)

使用预托管服务器URL:

https://reddit-mcp-production-79ca.up.railway.app/sse

或与ngrok自主机

  1. 在启用SSE的情况下运行服务器:

    SERVE_HTTPS=true uv run main.py
    
  2. 公开披露:

    ngrok http 8000
    
  3. 使用您的ngrok网址: https://your-subdomain.ngrok.io/sse

在ChatGPT中设置

  1. 首选 设置 → 应用程序和连接器
  2. 向下滚动至 高级设置 然后单击 创建应用程序
  3. 启用 开发者模式 (打开)
  4. 点击 创建应用程序 并填写:
    • 图标:上传Reddit MCP徽标(可选)
    • 名字: Reddit MCP
    • 描述: Browse, search, and analyze Reddit
    • MCP服务器URL: https://reddit-mcp-production-79ca.up.railway.app/sse
    • 认证:选择 No Auth
  5. 检查 “我理解并希望继续”
  6. 点击 创建

您的Reddit MCP连接器将出现在已启用的应用程序列表中。开始使用它!


🔐 身份验证(可选)

匿名访问是有效的,但OAuth解锁了更高的限制。

模式 速率限制 需要设置
匿名 ~10个请求/分钟 无
OAuth 约60个请求/分钟 客户端ID+密码

如何启用OAuth

  1. 首选 reddit.com/prefs/apps
  2. 点击 创建另一个应用程序
  3. 选择 脚本
  4. 复制您的 客户端ID 和 客户端密钥
  5. 在MCP设置过程中出现提示时输入它们

没有远程存储令牌。


🧰 可用的MCP工具

工具 说明
browse_subreddit 浏览来自任何子版块的帖子
search_reddit 按关键字搜索Reddit帖子
get_post_details 获取完整的帖子内容和评论
user_analysis 分析Reddit用户活动和业力

💬 查询示例

趋势与发现

  • “今天整个Reddit的趋势是什么?”
  • “向我展示研发/技术领域最热门的讨论”

搜索和意见

  • “人们对GPT-4有什么看法?”
  • “在r/cscareerquestions中查找有关远程工作的讨论”

帖子和评论分析

  • “从这篇Reddit帖子中获取完整的讨论”
  • “总结abc123帖子的热门评论”

用户分析

  • “分析Reddit用户spez”
  • “u/DeepFuckingValue发布了哪些子版块?”

📁 项目结构

reddit-mcp/
├── main.py           # MCP server entry point
├── reddit/
│   └── api.py        # Reddit API client (OAuth + anonymous)
├── manifest.json     # MCP bundle metadata
├── pyproject.toml    # Python dependencies
└── README.md

🤝 贡献

欢迎投稿!

  1. 克隆该仓库
  2. 创建要素分支
  3. 提交您的更改
  4. 打开拉取请求

想法:缓存、情感分析、主题聚类、总结。


📄 许可证

根据 MIT许可证.


Reddit MCP turns Claude into a real-time Reddit analyst.