Reddit MCP Buddy

社区

用于 Claude 桌面版和 AI 助手的 Reddit 浏览器。

分类: 其他第 213 / 230
Stars: ★ 849 非常热门
传输方式: stdio（本地进程）
运行环境: Node.js 18+ · Docker
凭据: 可选 API Key
许可证: MIT
最近提交: 2 个月前
工具数: 5

33FMRS · D

Reddit MCP Buddy 是一个专注于 Reddit 数据浏览的服务器，无需 API 密钥即可快速入门，并可选择添加凭据以解锁完整功能。它提供五项核心工具，强调真实数据而非生成指标，内置智能缓存和速率限制测试。主要限制包括仅支持 stdio 传输、官方仅与 Claude Desktop 兼容，以及匿名模式功能有限（需凭据才能搜索、评论和用户分析）。总体而言，对于想要将 Reddit 集成到 AI 工作流中的用户，它是一款可靠且高性能的服务器。

最强项 · 文档质量 8/20 最弱项 · 安全与权限 5/20

可靠性

7/20

安全与权限

5/20

维护活跃度

6/20

文档质量

8/20

安装易用性

7/20

查看各项评分依据

可靠性 7/20: 证据：README和清单列出了5个工具，但未提供真实的服务器源码（无src/、package.json、测试等）以供核实。手述的匿名和认证模式、RSS回退和缓存逻辑无法验证。未见CI或测试证据。因此，根据静态校准，可靠性评分不能超过12；由于对实际行为缺乏确证，推测功能可能正常，但错误处理、依赖控制等未得证实，故评分较低。扣分：无源码、无测试、无CI证据。
安全与权限 5/20: 证据：认证凭据通过环境变量或本地文件（--auth）处理，并承诺密码不写盘、令牌仅内存存储。HTTP模式默认绑定localhost，并有主机/来源限制。但未提供源码验证凭据处理逻辑。匿名模式使用RSS，无明确风险。未发现红旗行为。扣分：无法验证安全实现；缺少对HTTPS传输的明确说明；缺少对日志中凭据泄漏的防范细节。
维护活跃度 6/20: 证据：仓库有活跃的版本发布（1.1.14）和相对较高的星级，但未提供提交历史、问题响应时间或依赖更新细节。存在MIT许可证。由于缺乏具体证据，维护活跃度评分中等偏低。扣分：无提交/发布历史、问题解决时间或依赖更新记录。
文档质量 8/20: 证据：README非常详细，涵盖安装、认证、工具参数、速率限制、故障排除、隐私政策、环境变量和比较。示例和预期输出（如data_source）均有说明。扣分：缺少对每个工具具体输出模式的详细说明（如JSON结构示例）；文档常使用GIF演示，但未提供静态截图验证。
安装易用性 7/20: 证据：README提供了多种安装方式（npx、全局、源码、Docker、.mcpb）。针对Claude Desktop配置给出了明确的JSON示例。对于其他客户端，也有npx -y命令。扣分：没有验证安装步骤可在特定客户端一键完成；依赖节点版本和网络；未提供示例配置文件或逐步验证的截图。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

希望快速浏览 Reddit 而无需设置 API 密钥的用户
需要搜索和分析 Reddit 内容以获取实时信息的 AI 助手
需要高请求速率（最高 100 req/min）或可验证速率限制的应用
偏好真实数据而非虚假指标的开发者和研究人员

不适合谁

需要写入操作（发布、评论、投票）的用户——服务器是只读的
需要原生流式 HTTP 或 SSE 传输的用户——仅支持 stdio
需要支持除 Claude 之外的 MCP 客户端的用户——官方客户端列表仅包含 Claude Desktop

所需权限

网络访问以从 Reddit 的公共 API 和 RSS 源获取内容
本地文件存储用于可选的认证配置和缓存（凭据默认通过环境变量设置）
可选的环境变量，如 REDDIT_CLIENT_ID、REDDIT_CLIENT_SECRET、REDDIT_USERNAME、REDDIT_PASSWORD，用于认证

风险与副作用

未认证使用可能导致 Reddit 限流（HTTP 429）；服务器自动重试，但持续限流可能导致失败
HTTP 测试模式默认仅绑定到 localhost；将其暴露在网络（REDDIT_BUDDY_HOST=0.0.0.0）会带来安全风险
匿名模式从 RSS 获取数据，分数和评论数为 null——某些功能依赖凭据
Reddit 内容可能包含不当或冒犯性材料；NSFW 过滤仅在使用凭据时应用

安装接入

准备工作

运行环境：Node.js 18+ · Docker

REDDIT_CLIENT_SECRET 可选密钥同一 Reddit 应用的密钥，与 Client ID 搭配启用 60 请求/分钟的应用模式，属敏感信息。

REDDIT_PASSWORD 可选密钥 Reddit 账号密码，仅用于内存中的 OAuth 交换，不会写入磁盘，属敏感信息。

其他可选配置项（9 个）

REDDIT_CLIENT_ID 可选在 reddit.com/prefs/apps 创建 Reddit 应用后获得的客户端 ID，可选，用于解锁搜索和分析。

REDDIT_USERNAME 可选 Reddit 账号用户名，与密码一起启用 100 请求/分钟的完整认证模式。

REDDIT_USER_AGENT 可选自定义 User-Agent 字符串，仅在配置了凭据时生效。

REDDIT_BUDDY_HTTP 可选设为 true 时以 HTTP 模式而非默认 stdio 运行。

REDDIT_BUDDY_PORT 可选 HTTP 模式的监听端口，默认 3000。

REDDIT_BUDDY_HOST 可选 HTTP 服务器绑定的网络接口，默认 127.0.0.1。

REDDIT_BUDDY_ALLOWED_ORIGINS 可选允许调用 HTTP 端点的浏览器来源（逗号分隔）。

REDDIT_BUDDY_ALLOWED_HOSTS 可选 HTTP Host 头校验允许的 host:port 列表，用于防 DNS 重绑定。

REDDIT_BUDDY_NO_CACHE 可选设为 true 可禁用内存缓存，始终拉取最新数据。

对于 Claude Desktop：将配置添加到 claude_desktop_config.json：{"mcpServers":{"reddit":{"command":"npx","args":["-y","reddit-mcp-buddy"]}}}。或者，下载 .mcpb 扩展文件并打开它。对于 Claude Code：运行 claude mcp add --transport stdio reddit-mcp-buddy -s user -- npx -y reddit-mcp-buddy。也可通过 npm 全局安装或从源码构建。

claude_desktop_config.json

{
  "mcpServers": {
    "reddit": {
      "command": "npx",
      "args": [
        "-y",
        "reddit-mcp-buddy"
      ]
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "reddit": {
      "command": "npx",
      "args": [
        "-y",
        "reddit-mcp-buddy"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add reddit -- npx -y reddit-mcp-buddy

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 Claude Desktop 配置中添加 npx -y reddit-mcp-buddy 后重启客户端，工具列表应出现 browse_subreddit、search_reddit 等 5 个工具；直接问“Reddit 上现在什么在热榜？”能返回帖子即说明连接成功。

常见排障

确保 Node.js >= 18 且 npm 已安装，运行 `node --version` 和 `npm --version` 验证
如果搜索/评论/用户分析失败，请添加 Reddit 凭据；匿名模式仅支持浏览（RSS）和 reddit_explain
如果速率限制错误，请检查认证层级：匿名 10 req/min，使用脚本应用凭据 100 req/min
如果看不到预期结果，检查拼写（subreddit 不区分大小写，但必须正确）
如果连接问题，检查 Reddit 是否宕机或防火墙阻止请求

试试这样问

连接成功后，可以直接对 AI 助手这样说：

Reddit 上现在什么在热榜？
搜索一下关于 GPT-4 的讨论，按今天的热门排序
分析一下 Reddit 用户 spez 的发帖历史和活跃板块
解释一下 Reddit 的 karma 是什么意思

工具能力 5

browse_subreddit 只读

从任何 subreddit 浏览帖子，支持排序选项（热门、最新、最佳、上升、有争议）。支持时间范围、NSFW 过滤和 subreddit 元数据。

search_reddit 只读

在所有 subreddit 或特定 subreddit 中搜索 Reddit 内容。可按作者、时间范围、flair 筛选，并按相关性、热门、最佳、最新或评论排序。

get_post_details 只读

获取 Reddit 帖子的详细信息，包括完整评论线程。支持评论排序、深度控制和链接提取。

user_analysis 只读

分析 Reddit 用户的个人资料，包括 karma、发帖历史、活跃 subreddit 以及不同时间段的活动模式。

reddit_explain 只读

获取 Reddit 术语、俚语和文化的解释（karma、蛋糕日、AMA、ELI5 等），附带定义和使用示例。

使用场景

检查 Reddit 上正在流行的内容

搜索有关特定主题的讨论

获取帖子及其评论线程

分析用户的 Reddit 活动

了解 Reddit 术语和俚语

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

一个 Model Context Protocol (MCP) 服务器，使 Claude Desktop 和其他 AI 助手能够浏览 Reddit、搜索帖子并分析用户活动。干净、快速、真的能用——无需 API 密钥即可浏览 subreddit；添加免费 Reddit 凭据即可使用搜索、评论、用户分析和完整指标。支持三种认证层级（匿名 10 req/min、仅应用 60 req/min、已认证 100 req/min），内置智能缓存、隐私保护和速率限制测试工具。专为 LLM 优化，仅返回真实数据，不包含虚假指标。