关键词

RedditAI助手工具社交媒体分析内容浏览LLM外部功能

项目简介

Reddit Buddy MCP服务器是一个基于Model Context Protocol (MCP) 构建的后端服务，旨在将Reddit的丰富数据和功能无缝集成到大型语言模型（LLM）客户端（如Claude Desktop）中。它允许AI助手以标准化的方式访问Reddit的帖子、评论和用户信息，支持上下文感知交互和工具调用，而无需复杂的API配置或密钥。

主要功能点

  • 浏览Reddit资源：
    • 浏览任意Subreddit（如"technology"、"all"、"popular"）的帖子。
    • 支持按热门、最新、顶部、上升中、争议等多种排序方式。
    • 可设置时间范围（小时、天、周、月、年、全部）和帖子数量限制。
  • 搜索Reddit工具：
    • 在整个Reddit或指定Subreddit中搜索相关帖子。
    • 提供强大的过滤功能，可按查询、作者、时间、内容标签等进行筛选。
    • 支持按相关性、热门、顶部、最新、评论数量排序。
  • 获取帖子详情工具：
    • 根据Reddit URL或帖子ID获取完整的帖子内容及所有评论线程。
    • 支持评论排序、深度设置、链接提取，以及显示最多热门评论。
  • 用户分析工具：
    • 分析任何Reddit用户的个人资料，包括Karma值、发帖和评论历史、活跃Subreddit。
    • 提供用户账号年龄、兴趣爱好和近期活动的洞察。
  • Reddit术语解释工具：
    • 提供Reddit社区常用术语和俚语的权威解释，帮助AI理解Reddit文化。
  • 智能缓存系统：内置高性能缓存，减少重复API请求，提高响应速度并遵守Reddit的速率限制。
  • 灵活的传输协议：默认支持Stdio，方便与桌面AI助手集成；也支持Streamable HTTP模式，用于开发测试和更广泛的客户端集成。

安装步骤

  1. 准备环境：确保您的系统已安装 'Node.js' (版本 >= 18.0.0) 和 'npm'。
  2. 全局安装： 打开终端或命令行工具，运行以下命令进行全局安装： 
    npm install -g @karanb192/reddit-buddy-mcp
    或者，你也可以选择在需要时使用 'npx' 直接运行，而无需全局安装。
  3. 可选：配置Reddit认证（强烈推荐）： 配置认证可以大幅提升请求速率限制（从每分钟10次提升到100次）。
    • 创建Reddit应用：访问 'https://www.reddit.com/prefs/apps'。点击“Create App”或“Create Another App”。
      • 填写名称（例如“Reddit Buddy”）。
      • 应用类型请选择“script”（重要！）。
      • 描述可填写“Personal use”。
      • Redirect URI填写 'http://localhost:8080'。
      • 点击“Create app”。
    • 获取Client ID：在新创建的应用下方，找到“personal use script”字样，其下方即是你的Client ID（一串字母数字组合）。
    • 配置服务器认证：在终端运行以下命令，并按照提示输入你的Client ID： 
      reddit-buddy --auth
      认证成功后，Reddit Buddy MCP服务器将能够以更高频率访问Reddit API。

服务器配置

MCP服务器通常由MCP客户端（例如Claude Desktop）自动启动和管理。要让你的MCP客户端能够使用Reddit Buddy，你需要在客户端的配置中添加相应的条目。以下是一个典型的JSON格式配置示例及其说明：

{
  "mcpServers": {
    "reddit": {
      "command": "npx",
      "args": ["@karanb192/reddit-buddy-mcp"],
      "name": "Reddit Buddy",
      "description": "为AI助手提供Reddit内容浏览、搜索与用户分析工具"
    }
  }
}
  • 'mcpServers.reddit': 这是一个键，你可以自定义它（例如 'reddit-api'），但在客户端中，通常用这个名称来引用你的MCP服务器。
  • 'command': 指示MCP客户端启动此服务器时应执行的命令。这里是使用 'npx' 来运行已安装的 'reddit-buddy-mcp' 包。
  • 'args': 传递给 'command' 的参数列表。
  • 'name': （可选）在MCP客户端界面中显示的服务器名称。
  • 'description': （可选）在MCP客户端界面中显示的服务器描述。

关于认证信息的配置（可选）： 如果你已经通过 'reddit-buddy --auth' 设置了Reddit认证，并且希望MCP服务器在客户端启动时使用这些凭据（而非存储在文件系统中的凭据），可以在上述JSON配置中添加 'env' 字段来指定环境变量：

"env": {
  "REDDIT_CLIENT_ID": "你的Reddit应用Client ID",
  "REDDIT_USER_AGENT": "自定义的用户代理，例如YourApp/1.0"
}
  • 'REDDIT_CLIENT_ID': 你在Reddit创建的"script"类型应用的客户端ID。
  • 'REDDIT_USER_AGENT': 推荐自定义，用于标识你的应用。 请注意，对于"script"类型应用，通常不需要 'REDDIT_CLIENT_SECRET'。

基本使用方法

配置完成后，启动你的MCP客户端（如Claude Desktop）。在AI助手中，你可以直接使用自然语言提问，Reddit Buddy MCP服务器将通过其提供的工具来响应你的请求：

  • 浏览热门内容：
    • “Reddit上今天有什么热门帖子？”
    • “展示r/technology最近一周的顶部帖子。”
  • 搜索特定内容：
    • “搜索关于AI的Reddit讨论。”
    • “查找用户spez在r/science的所有帖子。”
  • 获取详细信息：
    • “获取这个Reddit帖子的所有评论：'https://reddit.com/r/...'”
  • 分析用户：
    • “分析用户DeepFuckingValue的发帖习惯和活跃社区。”
  • 理解Reddit术语：
    • “解释一下Reddit上的karma是什么意思。”

关键词

Reddit, AI助手工具, 社交媒体分析, 内容浏览, LLM外部功能

信息

分类

网页与API

访问项目