MCP Server Reddit Ts

🔴 Reddit MCP服务器

中文版 | 英语

一个全面的MCP服务器，用于通过Reddit API访问Reddit数据

🎯 概述

一个模型上下文协议（MCP）服务器，提供对Reddit数据的无缝访问，包括子版块、帖子、评论和搜索功能。内置TypeScript和官方Reddit API，可实现可靠快速的数据检索。

✨ 特性

• 🏠 子涡流信息：获取任何subreddit的详细信息
• 🔍 文章搜索：使用各种排序选项在subreddit中搜索帖子
• 📝 帖子详细信息：检索完整的帖子信息，包括内容和元数据
• 💬 评论：获取具有不同排序方法的帖子的评论
• 🌐 亚漩涡发现：搜索和发现新的子版块
• 🔑 OAuth身份验证：使用Reddit API凭据进行安全访问
• 🔄 自动令牌刷新：自动访问令牌管理
• 🎨 丰富的格式：格式良好、数据全面的回复
• ⚡ 高性能：高效的API调用，具有正确的错误处理

📦 安装

npm install reddit-mcp

或者直接与npx一起使用：

npx reddit-mcp

🔧 先决条件

在使用此MCP服务器之前，您需要获得Reddit API凭据：

1. 创建Reddit应用程序:

- 首选 Reddit应用程序首选项 - 点击“创建应用程序”或“创建另一个应用程序” - 为应用程序类型选择“脚本” - 记下你的 client_id 和 client_secret

1. 设置环境变量:

   export REDDIT_CLIENT_ID="your_client_id_here"
   export REDDIT_CLIENT_SECRET="your_client_secret_here"

或者创建一个 .env 文件：

   REDDIT_CLIENT_ID=your_client_id_here
   REDDIT_CLIENT_SECRET=your_client_secret_here

🔧 配置

克劳德桌面

{
  "mcpServers": {
    "reddit": {
      "command": "npx",
      "args": ["reddit-mcp"],
      "env": {
        "REDDIT_CLIENT_ID": "your_client_id_here",
        "REDDIT_CLIENT_SECRET": "your_client_secret_here"
      }
    }
  }
}

光标IDE

{
  "mcpServers": {
    "reddit": {
      "command": "npx",
      "args": ["reddit-mcp"],
      "env": {
        "REDDIT_CLIENT_ID": "your_client_id_here",
        "REDDIT_CLIENT_SECRET": "your_client_secret_here"
      }
    }
  }
}

VS代码与GitHub Copilot

{
  "mcp.servers": {
    "reddit": {
      "command": "npx",
      "args": ["reddit-mcp"],
      "transport": "stdio",
      "env": {
        "REDDIT_CLIENT_ID": "your_client_id_here",
        "REDDIT_CLIENT_SECRET": "your_client_secret_here"
      }
    }
  }
}

🛠️ 可用工具

get_subreddit

获取特定subreddit的详细信息。

参数：

• name （必填）：要检索的子版块的名称（不带“r/”前缀）

示例用法：

"Get information about the programming subreddit"
"Show me details for the MachineLearning subreddit"

退货：

• 子标题和描述
• 订阅者计数
• 创建日期
• NSFW状态
• 统一资源定位符

search_posts

在subreddit中搜索帖子或获取热门帖子。

参数：

• subreddit （必填）：要搜索的子版块的名称
• query （可选）：搜索查询字符串（如果为空，则返回趋势帖子）
• sort （可选）：排序方法-“相关性”、“热门”、“新”、“顶部”、“评论”（默认：“热门”）
• time （可选）：时间范围-“全部”、“小时”、“天”、“周”、“月”、“年”（默认值：“全部”）
• limit （可选）：返回的最大帖子数（1-100，默认值：10）

示例用法：

"Search for posts about 'artificial intelligence' in r/MachineLearning"
"Get the top 20 hot posts from r/programming"
"Find new posts about 'React' in r/webdev from the past week"

退货：

• 帖子标题和网址
• 作者信息
• 分数和评论数
• 用于进一步查询的帖子ID

get_submission

获取特定帖子的详细信息。

参数：

• id （必填）：岗位ID（带或不带“t3\_”前缀）

示例用法：

"Get details for post ID abc123"
"Show me the full content of post t3_xyz789"

退货：

• 完整的帖子标题和内容
• 作者和子版块信息
• 分数和评论统计
• 创建时间
• 帖子类型（文本或链接）

get_comments_by_submission

获取特定帖子的评论。

参数：

• submission_id （必填）：用于获取评论的帖子ID
• sort （可选）：评论排序方法-“置信度”、“顶部”、“新”、“有争议”、“旧”、“随机”、“质量保证”、“实时”（默认值：“置信度”）
• limit （可选）：要返回的最大评论数（1-100，默认值：10）

示例用法：

"Get the top 15 comments for post abc123"
"Show me the newest comments for post xyz789"

退货：

• 评论内容和作者
• 评论分数
• 创建时间戳
• 评论ID

get_comment

获取特定评论的详细信息。

参数：

• id （必填）：评论ID（带或不带“t1\_”前缀）

示例用法：

"Get details for comment ID def456"
"Show me comment t1_ghi789"

退货：

• 评论内容及作者
• 得分和创建时间
• 相关的subreddit和帖子
• 评论ID

search_subreddits

按名称或描述搜索子版块。

参数：

• query （必填）：搜索子版块名称或描述
• limit （可选）：要返回的最大子版块数（1-100，默认值：10）

示例用法：

"Search for subreddits about cooking"
"Find programming-related subreddits"

退货：

• 子目录名称和描述
• 订阅者计数
• NSFW状态
• 网址

🎮 使用示例

内容发现

"Find the most popular posts in r/technology from this week"
"Search for discussions about 'GPT-4' in r/MachineLearning"

研究与分析

"Get information about r/datascience and show me the top 10 posts"
"Find subreddits related to 'blockchain' and show their subscriber counts"

评论分析

"Get the top comments for post abc123 and analyze the sentiment"
"Show me controversial comments from post xyz789"

趋势监测

"What are the trending topics in r/programming today?"
"Search for posts about 'ChatGPT' across relevant subreddits"

🏗️ 发展

本地设置

# Clone the repository
git clone https://github.com/SzeMeng76/mcp-server-reddit-ts.git
cd mcp-server-reddit-ts

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env
# Edit .env with your Reddit API credentials

# Start the server
npm start

项目结构

mcp-server-reddit-ts/
├── index.js              # Main MCP server implementation
├── package.json          # Dependencies and scripts
├── .env.example          # Environment variables template
└── README.md            # Documentation

核心依赖关系

• @模型上下文协议/sdk：官方MCP服务器框架
• 节点获取：Reddit API调用的HTTP客户端
• Dotenv。：环境变量管理
• 动物圈：运行时类型验证和架构定义

🔧 技术细节

身份验证流程

• 使用OAuth 2.0客户端凭据流
• 过期时自动刷新令牌
• 通过环境变量实现安全的凭证处理

API速率限制

• 尊重Reddit API费率限制
• 实现正确的User-Agent标头
• 优雅地处理HTTP错误

数据处理

• 全面的数据格式，提高可读性
• 正确处理Reddit的嵌套评论结构
• 清洁ID处理（自动删除前缀）

错误处理

• 常见问题的详细错误消息
• API故障的优雅降级
• 正确验证输入参数

⚠️ 重要提示

Reddit API指南

• 关注Reddit API服务条款
• 遵守速率限制（每分钟60次客户端凭据请求）
• 使用描述性用户代理字符串
• 不要提出过多的要求

数据隐私

• 此服务器仅访问公共Reddit数据
• 无用户身份验证或私人数据访问
• 尊重Reddit的隐私设置和删除的内容

内容指南

• 访问某些子版块时，请注意NSFW内容
• 尊重社区规则和指导方针
• 负责任地使用数据进行研究和分析

🚀 常见用例

市场调研

• 趋势分析：监控有关产品或主题的讨论
• 情感分析：分析公众对品牌或活动的看法
• 社区见解：了解受众偏好和行为

内容策略

• 主题发现：查找相关社区的热门话题
• 啮合分析：研究哪些内容表现良好
• 社区研究：确定你所在领域的活跃社区

学术研究

• 社交媒体研究：分析在线社区动态
• 民意研究：研究态度和观点
• 内容分析：检查沟通模式

开发和测试

• API集成：测试应用程序中的Reddit数据集成
• 机器人开发：原型Reddit机器人和自动化工具
• 数据分析：处理Reddit数据以获取见解

🤝 贡献

1. 分叉存储库
2. 创建要素分支： git checkout -b feature-name
3. 通过适当的错误处理进行更改
4. 使用各种子版块和内容类型进行测试
5. 确保正确记录环境变量
6. 提交带有清晰描述的拉取请求

开发指南

• 遵循JavaScript/Node.js最佳实践
• 为新功能添加适当的错误处理
• 在热门和小众子版块进行测试
• 记录任何新参数或返回格式
• 遵守Reddit API指南和费率限制

📄 许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

⚖️ 法律与伦理

• Reddit API合规性：严格遵守Reddit的开发者条款
• 仅限公共数据：仅访问公开的Reddit内容
• 速率限制：遵守API限制以避免服务中断
• 内容责任：用户必须确保适当使用访问的数据
• 隐私尊重：无法访问私人消息或受限内容

🙏 致谢

• 红迪：用于提供全面的Reddit API
• MCP社区：用于标准化协议
• 节点获取维护者：用于可靠的HTTP客户端功能
• 贡献者：所有帮助改进这个项目的人

______________________________________________________________________

*专为Reddit数据分析、内容研究和社区洞察而构建* 🔴📊