Reddit数据摘要MCP服务器

项目简介

本项目是一个基于Model Context Protocol (MCP) 实现的服务器，专注于为LLM应用提供Reddit平台的数据访问能力。通过该服务器，LLM客户端可以便捷地获取Reddit用户的帖子、评论，以及搜索Reddit内容，从而更好地理解Reddit社区的讨论和信息。

主要功能点

用户数据获取: 提供工具以抓取指定Reddit用户的帖子和评论。
关键词搜索: 支持在Reddit帖子和评论中进行关键词搜索，快速定位相关信息。
子版块帖子获取: 允许获取特定Reddit子版块（Subreddit）的热门帖子。
帖子评论获取: 能够抓取指定Reddit帖子的全部评论内容。
数据以JSON格式返回: 所有工具返回的数据均为结构化的JSON格式，方便LLM客户端解析和使用。

安装步骤

安装 UV (推荐): UV 是一个快速的Python包管理器，推荐使用以获得更快的依赖安装速度。

curl -LsSf https://astral.sh/uv/install.sh | sh

克隆仓库: 将代码仓库克隆到本地。

git clone <repository-url>  # 将 <repository-url> 替换为仓库的实际URL
cd everyday-series-assignment

创建并激活虚拟环境: 为了隔离项目依赖，建议创建并激活Python虚拟环境。

uv init
source .venv/bin/activate  # 在 Unix/macOS 系统上
# OR
.venv\Scripts\activate  # 在 Windows 系统上

安装依赖: 安装项目所需的Python依赖包。

uv add requirements.txt

配置 RAPID API 密钥: 本项目使用了 RAPID API 来访问Reddit数据，你需要注册 RAPID API 并获取API密钥。
- 复制 '.env.example' 文件并重命名为 '.env'。
- 打开 '.env' 文件，将你的 RAPID API 密钥填入 'RAPIDAPI_KEY' 变量。

服务器配置

MCP客户端需要配置以下信息以连接到此MCP服务器：

{
  "serverName": "reddit-summary-mcp-server",  // MCP服务器的名称，可以自定义
  "command": "python",                      // 启动服务器的命令，这里使用 python
  "args": ["main.py"],                       // 启动服务器命令的参数，指定运行 main.py 文件
  "transport": "stdio",                     // (可选) 传输协议，默认为 stdio，也可以配置为 "websocket" 或 "sse"
  "port": null                              // (可选) 端口号，如果使用 stdio 或 websocket 且端口由服务器动态分配，则设置为 null
}

配置说明:

'serverName': 为你的MCP服务器指定一个易于识别的名称。
'command': 运行服务器端代码的命令，通常是Python解释器 'python'。
'args': 传递给 'command' 的参数，这里指定执行 'main.py' 文件。
'transport': (可选) 指定MCP客户端和服务器之间的通信方式，默认为 'stdio' (标准输入输出)。如果服务器配置为WebSocket或SSE，则需要相应修改。
'port': (可选) 如果服务器监听特定端口（例如WebSocket服务器），则需要指定端口号。对于 'stdio' 传输方式，通常设置为 'null' 或省略。

基本使用方法

确保已按照安装步骤配置好服务器。
启动MCP服务器：在项目根目录下运行 'python main.py' 命令。
配置MCP客户端：将上述 'mcp_config.json' 配置信息添加到你的MCP客户端配置中。
客户端通过MCP协议与服务器通信，调用预定义的工具（例如 'get_user_comments', 'search_posts' 等）来获取Reddit数据。
服务器会将请求的数据以JSON-RPC响应的形式返回给客户端。

注意: 使用前请务必确保已配置正确的 RAPID API 密钥，否则服务器将无法正常访问 Reddit 数据。

关键词