MCP Server Reddit

MCP Server Reddit

一个通过 Reddit 公共 API 为大模型提供访问能力的 Model Context Protocol 服务。此服务支持大模型与 Reddit 内容交互，包括浏览首页帖子、访问 subreddit 信息以及阅读帖子评论。

此服务使用 redditwarp 与 Reddit 公共 API 交互，并通过 MCP 协议提供相关功能。

视频演示（点击观看）

Clinde 中的演示 👇

可用工具

• get_frontpage_posts - 获取 Reddit 首页的热门帖子

  • 可选参数：
    • limit（integer）：返回的帖子数量（默认值：10，范围：1-100）

• get_subreddit_info - 获取 subreddit 信息

  • 必需参数：
    • subreddit_name（string）：subreddit 的名称（例如 'Python'、'news'）

• get_subreddit_hot_posts - 获取指定 subreddit 的热门帖子

  • 必需参数：
    • subreddit_name（string）：subreddit 的名称（例如 'Python'、'news'）
  • 可选参数：
    • limit（integer）：返回的帖子数量（默认值：10，范围：1-100）

• get_subreddit_new_posts - 获取指定 subreddit 的最新帖子

  • 必需参数：
    • subreddit_name（string）：subreddit 的名称（例如 'Python'、'news'）
  • 可选参数：
    • limit（integer）：返回的帖子数量（默认值：10，范围：1-100）

• get_subreddit_top_posts - 获取指定 subreddit 的最佳帖子

  • 必需参数：
    • subreddit_name（string）：subreddit 的名称（例如 'Python'、'news'）
  • 可选参数：
    • limit（integer）：返回的帖子数量（默认值：10，范围：1-100）
    • time（string）：最佳帖子的时间筛选条件（默认值：''，选项：'hour'、'day'、'week'、'month'、'year'、'all'）

• get_subreddit_rising_posts - 获取指定 subreddit 中热度上升的帖子

  • 必需参数：
    • subreddit_name（string）：subreddit 的名称（例如 'Python'、'news'）
  • 可选参数：
    • limit（integer）：返回的帖子数量（默认值：10，范围：1-100）

• get_post_content - 获取指定帖子的详细内容

  • 必需参数：
    • post_id（string）：帖子的 ID
  • 可选参数：
    • comment_limit（integer）：返回的顶级评论数量（默认值：10，范围：1-100）
    • comment_depth（integer）：评论树的最大深度（默认值：3，范围：1-10）

• get_post_comments - 获取帖子的评论

  • 必需参数：
    • post_id（string）：帖子的 ID
  • 可选参数：
    • limit（integer）：返回的评论数量（默认值：10，范围：1-100）

安装

使用 Clinde（推荐）

使用 MCP Server Reddit 最简单的方式是通过 Clinde 桌面应用。只需下载并安装 Clinde，然后：

1. 打开 Clinde 应用
2. 前往 Servers 页面
3. 找到 mcp-server-reddit 并点击 Install

就是这样！无需任何技术知识，Clinde 会为你轻松完成所有安装和配置。

使用 uv（推荐）

使用 uv 时无需进行特定安装。我们将使用 uvx 直接运行 mcp-server-reddit。

使用 PIP

你也可以通过 pip 安装 mcp-server-reddit：

pip install mcp-server-reddit

安装后，你可以将其作为脚本运行：

python -m mcp_server_reddit

通过 Smithery 安装

通过 Smithery 为 Claude Desktop 自动安装 MCP Server Reddit：

npx -y @smithery/cli install @Hawstein/mcp-server-reddit --client claude

配置

为 Claude.app 配置

添加到你的 Claude 设置中：

"mcpServers": {
  "reddit": {
    "command": "uvx",
    "args": ["mcp-server-reddit"]
  }
}

"mcpServers": {
  "reddit": {
    "command": "python",
    "args": ["-m", "mcp_server_reddit"]
  }
}

为 Zed 配置

添加到你的 Zed settings.json：

"context_servers": [
  "mcp-server-reddit": {
    "command": "uvx",
    "args": ["mcp-server-reddit"]
  }
],

"context_servers": {
  "mcp-server-reddit": {
    "command": "python",
    "args": ["-m", "mcp_server_reddit"]
  }
},

问题示例

• “Reddit 首页当前有哪些热门帖子？”（get_frontpage_posts）
• “介绍一下 r/ClaudeAI 子版块。”（get_subreddit_info）
• “r/ClaudeAI 子版块有哪些热门帖子？”（get_subreddit_hot_posts）
• “显示 r/ClaudeAI 的最新帖子。”（get_subreddit_new_posts）
• “r/ClaudeAI 历史上最热门的帖子有哪些？”（get_subreddit_top_posts）
• “r/ClaudeAI 现在有哪些帖子正在走红？”（get_subreddit_rising_posts）
• “获取这篇 Reddit 帖子的完整内容和评论：[post_url]”（get_post_content）
• “总结这篇 Reddit 帖子的评论：[post_url]”（get_post_comments）

调试

你可以使用 MCP 检查器调试服务。对于 uvx 安装：

npx @modelcontextprotocol/inspector uvx mcp-server-reddit

如果你已将软件包安装在特定目录中，或正在开发该软件包，也可以使用：

cd path/to/mcp_server_reddit
npx @modelcontextprotocol/inspector uv run mcp-server-reddit

许可证

mcp-server-reddit 采用 MIT 许可证授权。这意味着你可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。详情请参阅项目仓库中的 LICENSE 文件。