Reddit Content API

Reddit 内容 API - 设置和使用指南

该项目提供了通过 Claude 和 Cursor 与 Reddit 交互的 MCP（模型上下文协议）工具。

特征

• 阅读子版块的热门帖子
• 分析 Reddit 讨论和评论
• 在 Reddit 上创建帖子
• 向帖子添加评论或回复现有评论
• 对帖子和评论进行投票

要求

• Python 3.10+
• Reddit 帐户
• 已注册的 Reddit 应用程序（用于获取 client_id 和 client_secret）
• 虚拟环境（venv 或类似）
• Claude Desktop 和/或 Cursor（可选但推荐）

从头开始安装

请仔细按照以下步骤操作以避免导入和配置问题：

⚠️重要提示：请勿在可编辑模式下安装包（ pip install -e . ），因为它可能导致模块导入问题。

环境配置

1. 在项目根目录中创建一个.env文件，其中包含以下变量：

2. 要获取刷新令牌，请运行：

按照说明授权应用程序。令牌将自动保存到.env文件中。

项目结构

直接运行服务器

手动运行（对于开发和测试有用）：

您应该会看到以下日志：

• 服务器初始化
• Reddit 身份验证
• 注册 10 个工具（5 个原版 + 5 个带前缀）
• “正在运行 MCP 服务器...”

Claude桌面配置

1. 找到配置文件：
   • 在 macOS 上： /Users/your-username/Library/Application Support/Claude/claude_desktop_config.json
   • 在 Windows 上： %APPDATA%\Claude\claude_desktop_config.json
2. 添加reddit-content-api的配置：

⚠️极其重要： PYTHONPATH必须同时包含src目录和项目根目录，按此顺序，以:在 Unix/macOS 上）或; （在 Windows 上）分隔

游标配置

1. 找到配置文件：
   • 在 macOS 上： /Users/your-username/.cursor/mcp.json
   • 在 Windows 上： %USERPROFILE%\.cursor\mcp.json
2. 添加与 Claude 相同的配置，根据需要调整路径。

常见问题故障排除

问题：仅显示 2 个工具，而不是预期的 10 个

症状：运行服务器时，仅出现 2 个工具，而不是预期的 10 个。

可能的原因和解决方案：

1. 导入问题：Python 正在从site-packages导入已安装的版本，而不是src/中的本地代码。解决方案：
   • 确保不要以可编辑模式安装包（ pip install -e . ）
   • 在配置中明确将src添加到PYTHONPATH的开头
   • 如果您已经安装了它，请使用pip uninstall reddit-content-api将其删除
2. Python 缓存：旧的.pyc文件可能会导致问题。解决方案：
   • 从项目中删除所有__pycache__目录
3. 版本冲突：同一个库的不同版本。解决方案：
   • 使用pip install -r requirements.txt重新安装依赖项

问题：“无法创建帖子：Reddit 身份验证未正确配置”

原因：刷新令牌无效或已过期。

解决方案：通过运行python -m mcp_reddit.auth_helper重新生成令牌，并确保其保存在.env中。

问题：Claude/Cursor 中不显示工具

原因：配置文件中的配置不正确。

解决方案：

• 检查配置文件中的路径，特别是PYTHONPATH
• 修改配置后彻底重启Claude/Cursor

使用 Claude/Cursor 中的工具

配置完成后，您可以使用以下工具：

1. mcp_reddit_content_api_fetch_reddit_hot_threads - 获取热门帖子
2. mcp_reddit_content_api_fetch_reddit_post_content - 分析帖子及其评论
3. mcp_reddit_content_api_create_reddit_post - 创建新帖子
4. mcp_reddit_content_api_add_reddit_comment - 添加评论
5. mcp_reddit_content_api_vote_on_reddit_content - 对内容进行投票

示例

获取热门帖子：

创建帖子：

贡献

如果您发现问题或有改进，请创建问题或提交拉取请求。

执照

麻省理工学院

支持这个项目

如果您发现该项目对您的工作或研究有用，请考虑：

• ⭐ 为存储库加星标以表示您的支持
• 🔄 关注代码库以获取新功能和改进的更新
• 🐛 提交 Bug 或功能请求的问题
• 🛠️ 如果您有改进想要分享，请通过 Pull 请求进行贡献

您的支持有助于让这个项目更好地服务于每个人！