ismailsaoulaj/reddit-mcp-server

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

37 stars 1 forks 质量 79 趋势 20MIT

Repository Install

一个生产级模型上下文协议（MCP）服务器。赋能AI助手（Claude、Cursor）以韧性限制速率和智能LLM噪声搜索、获取和分析Reddit讨论......

概览

为你的AI助手提供一个实时、结构化的Reddit窗口——无需API密钥。是一个开源的模型上下文协议（MCP）服务器，实时连接 AI 助手（Claude、Cursor、Open WebUI 等）与 Reddit 内容。它提供结构化工具，用于搜索讨论、提取社区意见和跟踪细分趋势——配备一个韧性的多层备份引擎，即使没有任何凭证也能正常工作。这里有一个可视化序列图，展示了AI模型如何与该服务器（包括我们的系统）交互： - 🚀 开箱即用。无需 Reddit API 密钥——它会自动退回到 DuckDuckGo 和 Arctic Shift 档案。- 🛡️ 官方 OAuth →会话 Cookie →浏览器模拟的 JSON → Arctic Shift RSS → DDG。即使 Reddit 有速率限制或缺少凭证，AI 也始终能获得数据。

概述（AI 翻译）

给你的AI助手一个实时、结构化的Reddit窗口——完全不需要API密钥。

Reddit MCP 服务器 是一个开源的模型上下文协议（MCP）服务器，实时连接 AI 助手（Claude、Cursor、Open WebUI 等）与 Reddit 内容。它提供结构化工具，用于搜索讨论、提取社区意见和追踪细分趋势——配备一个即使没有凭证也能运行的多层次备份引擎。

🗺️ 工作原理（数据流序列）

这里有一个可视化序列图，展示了AI模型如何与该服务器交互，包括我们的零配置备份系统：

✨ 特色

🚀 Zero-Config Ready： 开箱即用。无需Reddit API密钥——会自动退回DuckDuckGo和Arctic Shift档案。
🛡️ 级联多层引擎： Official OAuth → Session Cookie → Browser-Impersonated JSON → Arctic Shift RSS → DDG。即使Reddit有速率限制或缺少凭证，AI也总是能获得数据。

本页由 AI 翻译，技术细节请以原文为准。

README

以下为原文 README 节选，完整内容请查看原文。

Reddit MCP Server

Give your AI assistant a live, structured window into Reddit — zero API keys required.

Reddit MCP Server is an open-source Model Context Protocol (MCP) server that connects AI assistants (Claude, Cursor, Open WebUI, and more) to Reddit’s content in real time. It provides structured tools for searching discussions, extracting community opinions, and tracking niche trends — with a resilient multi-tier fallback engine that works even without any credentials.

# Get started in one command — no sign-up, no API keys
uvx reddit-mcp-ai

🗺️ How it Works (Data Flow Sequence)

Here is a visual sequence diagram showing how the AI model interacts with this server, including our Zero-Config Fallback system:

sequenceDiagram
    autonumber
    actor AI as AI Assistant (Claude/Cursor)
    participant MCP as FastMCP Server (STDIO)
    participant Tools as Application Tools
    participant Reddit as Reddit API (OAuth)
    participant Fallback as DDG & Arctic Shift

    AI->>MCP: Request (e.g., search_knowledge)
    MCP->>Tools: Route request
    Tools->>Reddit: Attempt Fetch (Resilient HTTP)
    alt Has OAuth Credentials & API Healthy
        Note over Reddit,Tools: Handles 429 (Rate Limits) with Retry-After backoff!
        Reddit-->>Tools: Return Official JSON payload
    else Zero-Config OR Reddit API Fails
        Note over Tools,Fallback: Graceful Degradation Active
        Tools->>Fallback: Execute Search / Fetch Archive
        Fallback-->>Tools: Return Alternative JSON payload
    end
    Tools->>Tools: Refine comments (filter bots & short noise)
    Tools-->>MCP: Map to Domain Models (Pydantic)
    MCP-->>AI: Return clean JSON-RPC Response (stdout-safe)

✨ Features

🚀 Zero-Config Ready: Works completely out of the box. No Reddit API keys required — it falls back automatically to DuckDuckGo and the Arctic Shift archive.
🛡️ Cascading Multi-Tier Engine: Official OAuth → Session Cookie → Browser-Impersonated JSON → Arctic Shift RSS → DDG. The AI always gets data, even when Reddit is rate-limiting or credentials are missing.
🚦 Built-in Anti-Ban Shields: Token bucket rate limiter, global concurrency semaphore, and singleflight request coalescing prevent WAF 403 blocks and IP bans under heavy AI traffic.

在 GitHub 查看完整 README

安装

uvx reddit-mcp-ai

新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "reddit": {
      "command": "uvx",
      "args": [
        "reddit-mcp-ai"
      ]
    }
  }
}