reddit-mcp-server
eliasbiondo/reddit-mcp-server加载项目详情…
本应用为开源项目，仅供学习研究，请遵守其开源协议。
微信扫码咨询客服
POMOAI — 让开源 AI 即刻运行
加载项目详情…
本应用为开源项目，仅供学习研究，请遵守其开源协议。
想象一下这样的场景：你正在开发一个 AI 助手应用，希望它能引用 Reddit 上的热门讨论来增强回答的时效性和社区智慧。但 Reddit 的官方 API 从 2023 年开始收费，第三方爬虫又要处理复杂的反爬机制，这让很多开发者望而却步。Reddit MCP Server 正是为解决这一痛点而生——它通过底层封装 Reddit 的 JSON API，让任何支持 Model Context Protocol（MCP）的 AI 助手都能直接、合法地浏览和搜索 Reddit 内容，无需任何 API Key，无需注册账号，拿起就用。
图 1：Reddit MCP Server 通过 MCP 协议为 AI 助手提供 Reddit 数据访问能力
这个项目由独立开发者 Elias Biondo 创建，核心依赖是一个同样由他维护的轻量级库 redd（纯 Python 实现的 Reddit JSON API 封装），而非 PRAW（Python Reddit API Wrapper）或 BS4 爬虫，因此完全不依赖 Reddit 的 OAuth 认证体系，也就不会触发 Reddit 的 API 速率限制警告。项目当前版本为 0.1.2，属于早期阶段（Alpha），但核心功能已覆盖 Reddit 数据访问的主要场景。
Reddit MCP Server 在代码架构上采用了经典的 Hexagonal Architecture（六边形架构，又称端口与适配器模式），这是近年来在 Python 生态中越来越受青睐的分层策略，尤其适合需要对接外部服务的中介层工具。其目录结构如下：
src/reddit_mcp_server/
├── domain/ # 纯业务逻辑，零框架依赖
│ ├── exceptions.py # 领域异常类层次结构
│ └── value_objects.py # 不可变配置对象
├── ports/ # 抽象接口层（契约定义）
│ ├── config.py # 配置端口
│ └── reddit.py # Reddit 数据访问端口
├── application/ # 用例编排层（核心业务）
│ ├── search.py
│ ├── search_subreddit.py
│ ├── get_post.py
│ ├── get_user.py
│ ├── get_subreddit_posts.py
│ └── get_user_posts.py
├── adapters/
│ ├── inbound/ # 适配Inbound（接入层）
│ │ ├── mcp_server.py
│ │ ├── serialization.py
│ │ └── mcp_tools/ # MCP 工具定义
│ └── outbound/ # 适配Outbound（外部服务）
│ ├── env_config.py # 环境变量配置实现
│ └── redd_client.py # Reddit API 客户端实现
└── container.py # 依赖注入组合根
六边形架构的精髓在于"依赖倒置"——domain 层完全不依赖任何外部库，所有外部依赖（Reddit API、配置来源）都通过 ports 接口注入。这种设计带来的直接好处是：替换 Reddit 数据源（如改用 PRAW 或自建爬虫）时，不需要修改任何业务逻辑代码，只需新增一个 adapter 实现即可。对于需要深度定制的企业用户来说，这是非常重要的架构灵活性。
从技术栈角度看，项目主力语言为 Python 3.12+，使用 FastMCP 作为 MCP 协议实现框架，配合 uv 作为包管理工具（而非传统的 pip/poetry），这是 2024-2025 年 Python 生态中快速崛起的现代化工具链。FastMCP 相比官方 MCP SDK 提供了更简洁的装饰器语法，降低了工具注册的心智负担。
项目提供了 6 个 MCP 工具，覆盖了 Reddit 数据消费的核心场景：
| 工具名称 | 功能描述 | 典型使用场景 |
|---|---|---|
search | 全站搜索 | "帮我找最近一周关于 AI coding 的讨论" |
search_subreddit | 子版块内搜索 | "在 r/MachineLearning 里找关于 LoRA 的帖子" |
get_subreddit_posts | 获取版块帖子列表 | "列出 r/Python 今日热门" |
get_post | 获取帖子详情+评论树 | "查看某个帖子的完整讨论" |
get_user | 用户活动轨迹 | "看看某个用户最近都在讨论什么" |
get_user_posts | 用户发帖历史 | "查看某用户的精华帖" |
这些工具的参数设计非常实用：get_subreddit_posts 支持按 hot（热门）、top（最高分）、new（最新）、rising（上升中）分类，还支持 time_filter（时间范围：小时/天/周/月/年/全部），几乎可以还原 Reddit 网页版的筛选能力。对于需要批量数据的场景，limit 参数可控制返回数量。
特别值得注意的是，这些工具都支持 异步并发请求，底层通过 redd 库的异步客户端实现，每次请求之间有 REDDIT_THROTTLE_MIN/MAX（默认 1-2 秒）的随机延迟，避免对 Reddit 服务器造成压力。
项目最大的产品亮点是极简部署。开发者提供了三种启动方式，复杂度从低到高：
方式一（推荐）：uvx 一行命令
uvx reddit-no-auth-mcp-server
这是最优雅的方案——uvx 是 uv 的在线运行工具，不需要克隆仓库、不需要安装依赖，一条命令直接拉起服务。默认以 stdio 传输模式运行，AI 助手（如 Claude Desktop、Cursor）通过标准输入/输出与之通信。
方式二：HTTP 模式
uvx reddit-no-auth-mcp-server --transport streamable-http --port 8000
以 HTTP 服务器模式运行，适合远程部署或对接非本地 AI 服务。
方式三：从源码运行
git clone https://github.com/eliasbiondo/reddit-mcp-server.git
cd reddit-mcp-server
uv sync
uv run reddit-no-auth-mcp-server
适合需要调试或二次开发的场景。
配置方面，所有参数均支持环境变量覆盖（REDDIT_PORT、REDDIT_TIMEOUT、REDDIT_PROXY 等），对于需要通过代理访问 Reddit 的中国开发者来说，只需设置 REDDIT_PROXY 即可。CLI 参数的优先级高于环境变量，提供了充分的灵活性。
当前版本 0.1.2 标注为 Alpha 阶段，意味着核心功能虽已可用，但接口设计尚未稳定，未来可能有破坏性变更。license 为 MIT，可自由商用。
从实测角度看，以下几点值得注意：
Reddit 是全球最大的社区内容平台之一，其数据对于训练数据收集、舆情分析、产品调研等场景具有极高价值。MCP 协议（Model Context Protocol）由 Anthropic 主推，正在成为 AI 助手与外部工具交互的事实标准。Reddit MCP Server 填补了 MCP 生态中 Reddit 数据访问的空白，让 AI 应用开发者无需再处理 Reddit 复杂的 OAuth 流程。
从项目增长看，145 stars 在 MCP Server 类工具中属于中等体量，但考虑到其"零配置"的产品定位和完全免费的使用成本，在 AI 助手开发者群体中具有不错的口碑传播潜力。随着 MCP 协议的生态扩大，类似的数据源 MCP Server（YouTube、Github、Notion 等）正在形成 MCP 工具矩阵，Reddit MCP Server 是其中一块重要的拼图。