IR

ismailsaoulaj/reddit-mcp-server

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

37 stars 0 forks 品質 79 トレンド 20MIT

生産グレードのモデルコンテキストプロトコル(MCP)サーバー。 AIアシスタント(Claude、Cursor)をエンパワーし、Resilientのレート制限とスマートLLMノイズでRedditの議論を検索、フェッチ、分析します。...

概要

AI アシスタントをライブ、構造化されたウィンドウを Reddit に — 必要な API キーをゼロにします。 AIアシスタント(Claude、Cursor、Open WebUIなど)をリアルタイムでRedditのコンテンツに接続するオープンソースモデルコンテキストプロトコル(MCP)サーバーです。 ディスカッションを検索したり、コミュニティの意見を抽出したり、ニッチのトレンドを追跡したりするための構造化されたツールを提供します。それは、任意の資格情報なしでも機能する弾力性のあるマルチ層フォールバックエンジンを備えています。 ここでは、AIモデルがこのサーバーとどのように相互作用するかを示すビジュアルシーケンス図です。 - 箱から完全に働きます。 Reddit API キーは不要で、DuckDuckGo と Arctic Shift アーカイブに自動的にフォールトされます。 - 🛡️公式OAuth → セッションクッキー → ブラウザ・Impersonated JSON → アークティックシフトRSS → DDG. Redditがレート制限や資格情報が不足している場合でも、AIは常にデータを取得します.

概要(AI 翻訳)

人工知能アシスタントにライブ、構造化されたウィンドウをRedditに — 必要なAPIキーをゼロにします。

Reddit MCP Serverは、AIアシスタント(Claude、Cursor、Open WebUIなど)をRedditのコンテンツにリアルタイムで接続するオープンソースモデルコンテキストプロトコル(MCP)サーバーです。 ディスカッションを検索したり、コミュニティの意見を抽出したり、ニッチのトレンドを追跡したりするための構造化されたツールを提供します。それは、任意の資格情報なしでも機能する弾力性のあるマルチ層フォールバックエンジンを備えています。

お問い合わせ

送信する❤ 使い方 (データフローシーケンス)

ここでは、AIモデルがこのサーバーとどのように相互作用するかを示すビジュアルシーケンス図です。

お問い合わせ

✨ 機能

  • OST ゼロ構成準備: 箱から完全に働きます。 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
MCP 初心者?mcpskill.org のガイドから始めましょう →

設定

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