MCP Reddit Server

MCP Reddit Server

site icon
2025.01.02 5
PythonReddit交互AI助手内容生成交流协作
MCP Reddit Server 是一个基于MCP(Model Context Protocol)协议的Reddit服务器,专门设计用于与Claude等大语言模型进行交互。通过这个服务,AI助手可以帮助用户浏览和分析Reddit上的内容。
View on GitHub

Overview

基本能力

产品定位

MCP Reddit Server 是一个专门用于与Reddit交互的MCP服务器,旨在帮助AI助手获取和分析Reddit上的内容。

核心功能

  • 搜索特定subreddit中的帖子
  • 获取帖子详细信息和评论
  • 浏览subreddit中的热门帖子

适用场景

  • AI助手需要获取Reddit上的信息时
  • 需要分析特定subreddit的内容时
  • 需要浏览热门帖子时

工具列表

  1. search_subreddit: 搜索特定subreddit中的帖子
  2. 参数:subreddit(subreddit名称)、query(搜索关键词)、limit(最大返回结果数,默认:5)
  3. get_post_details: 获取特定帖子的详细信息
  4. 参数:post_id(Reddit帖子ID)、comment_limit(获取评论的最大数量,默认:10)
  5. get_subreddit_hot: 获取subreddit中的热门帖子
  6. 参数:subreddit(subreddit名称)、limit(返回帖子的最大数量,默认:5)

常见问题解答

  1. 安全性
  2. 请妥善保管你的Reddit API凭证
  3. 不要在公共场合分享你的配置文件
  4. 建议使用环境变量而不是硬编码凭证
  5. 使用限制
  6. Reddit API有调用频率限制
  7. 默认返回的评论数量限制为10条
  8. 搜索结果默认限制为5条
  9. 故障排除
  10. 检查API凭证是否正确
  11. 确保网络连接正常
  12. 查看日志输出了解详细错误信息

使用教程

使用依赖

  1. Docker(必须)
  2. Python 3.12+(用于本地开发)
  3. Reddit API凭证(必需)

安装教程

Docker安装(MAC用户)

  1. 访问 Docker 官网:https://www.docker.com/products/docker-desktop
  2. 点击 "Download for Mac"
  3. 选择对应你的 Mac 芯片的版本(Apple Silicon 或 Intel)
  4. 下载并安装 .dmg 文件
  5. 验证安装:
# 检查 Docker 版本
docker --version

# 运行测试容器
docker run hello-world
  1. 确保 Docker 服务正在运行:
# 检查 Docker 服务状态
docker ps

本地开发安装

  1. 克隆仓库
git clone https://github.com/nangeplus/mcp-reddit.git
cd mcp-reddit
  1. 安装依赖
pip install -r requirements.txt
  1. 运行服务器
python src/server.py

调试方式

  1. 检查API凭证是否正确
  2. 确保网络连接正常
  3. 查看日志输出了解详细错误信息

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。