返回 MCP 目录
public公开dns本地运行

Reddit MCP

一个即插即用的MCP服务器,用于浏览、搜索和阅读Reddit内容。

article

README

🚀 Reddit MCP GitHub 项目

一个即插即用的 MCP 服务器,可用于浏览、搜索和阅读 Reddit,为用户提供便捷的 Reddit 交互体验。

🚀 快速开始

你可以通过观看下方的演示视频,了解如何在 Claude Desktop 中使用本项目: https://github.com/user-attachments/assets/a2e9f2dd-a9ac-453f-acd9-1791380ebdad

✨ 主要特性

  • 运用 pydantic 进行详细的参数验证,确保输入数据的准确性。
  • 依赖可靠的 PRAW 库作为后端支持,保障服务器的稳定运行。
  • 内置速率限制保护,得益于 PRAW 的功能,有效防止过度请求。

⚠️ 重要提示

⚠️ 重要提示

  • 目前仅支持读取功能。如果你想使用写入功能,请投票支持该问题或贡献代码! 🙌
  • 工具使用代币。要与 Claude 一起使用此工具,可能需要成为 Pro 用户才能进行多次工具调用。免费用户也可以轻松使用轻量级工具调用。代币使用风险自担。

📦 安装指南

先决条件:Reddit API 凭证

若你还没有 Reddit API 凭证,请创建一个 开发者应用,这将为你提供 client_idclient_secret 用于后续步骤。若你已经拥有这些信息,可以跳过此步。

在 Claude Desktop 中安装

按照以下步骤进行操作:

  • 遵循 此处 的说明,直到“以任何文本编辑器打开配置文件”部分。
  • 根据你的首选安装方法添加以下内容到文件中:

使用 uvx(推荐)

"mcpServers": {
  "reddit": {
    "command": "uvx",
    "args": ["reddit-mcp"],
    "env": {
      "REDDIT_CLIENT_ID": "<client_id>",
      "REDDIT_CLIENT_SECRET": "<client_secret>"
    }
  }
}

使用 PIP 安装

首先安装包:

pip install reddit-mcp

然后添加以下内容到配置文件中:

"mcpServers": {
  "reddit": {
    "command": "python",
    "args": ["-m", "reddit_mcp"],
    "env": {
      "REDDIT_CLIENT_ID": "<client_id>",
      "REDDIT_CLIENT_SECRET": "<client_secret>"
    }
  }
}

其他方法

你可以使用任何 MCP 客户端,包括各种代理框架(如 LangChain、LlamaIndex、AutoGen 等)。有关 AutoGen 集成的示例,请查看 示例

📚 详细文档

提供的工具

该服务器将暴露以下工具: | 名称 | 描述 | | ---------------------------- | ---------------------------------------- | | get_comment | 访问一个评论 | | get_comments_by_submission | 获取某个提交下的所有评论 | | get_submission | 访问一个提交 | | get_subreddit | 通过名称访问一个 subreddit | | search_posts | 在 subreddit 中搜索帖子 | | search_subreddits | 搜索 subreddit 的名称或描述 |

🤝 贡献指南

欢迎贡献!有关详细信息,请参阅 CONTRIBUTING.md

🙏 致谢

感谢 PRAW 库的支持,为项目提供了强大的功能支撑。

📄 许可证

本项目采用 MIT 许可证MIT License

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端