IR

ismailsaoulaj/reddit-mcp-server

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

37 stars 1 forks 품질 79 트렌드 20MIT

생산 등급 모델 Context Protocol (MCP) 서버. Empowers AI Assistants (Claude, Cursor) 검색, fetch 및 탄력 속도 제한 및 스마트 LLM 소음과 Reddit 토론을 분석 ...

개요

AI 조력자가 살고, 구조화 된 창을 Reddit로 - 0 API 키가 필요합니다. 오픈 소스 모델 Context Protocol (MCP) 서버는 AI 조수 (Claude, Cursor, Open WebUI 등)를 실시간 Reddit의 콘텐츠에 연결합니다. 그것은 토론을 검색하기위한 구조화 된 도구를 제공하며, 지역 사회의 의견을 추출하고, 틈새 트렌드를 추적합니다. - 어떤 자격없이도 작동하는 탄력있는 멀티 계층 fallback 엔진. 여기에서 AI 모델이 우리 시스템을 포함한이 서버와 상호 작용하는 방법을 보여주는 시각적 순서도입니다. - 상자에서 완전히 작동합니다. Reddit API 키가 필요하지 않습니다. DuckDuckGo 및 Arctic Shift 아카이브에 자동으로 떨어졌습니다. - O️ 공식 OAuth → 세션 쿠키 → Browser-Impersonated JSON → Arctic Shift RSS → DDG. AI는 항상 데이터, Reddit가 속도 제한 또는 자격 증명이 누락 될 때.

개요(AI 번역)

AI 조력자가 살고, 구조화 된 창을 Reddit로 - 0 API 키가 필요합니다.

Reddit MCP Server는 실시간 Reddit의 콘텐츠에 AI Assistants (Claude, Cursor, Open WebUI 등)를 연결하는 오픈 소스 모델 Context Protocol (MCP) 서버입니다. 그것은 토론을 검색하기위한 구조화 된 도구를 제공하며, 지역 사회의 의견을 추출하고, 틈새 트렌드를 추적합니다. - 어떤 자격없이도 작동하는 탄력있는 멀티 계층 fallback 엔진.


過去️ 어떻게 작동하나요?

여기에서 AI 모델이 우리의 Zero-Config Fallback 시스템을 포함하여이 서버와 상호 작용하는 방법을 보여주는 시각 순서도입니다:


✨ 특징

  • ♨ 영-Config 준비: 상자에서 완전히 작동합니다. Reddit API 키가 필요하지 않습니다. DuckDuckGo 및 Arctic Shift 아카이브에 자동으로 떨어졌습니다.
  • Multi️ ** Multi-Tier Engine :** Official OAuth] → Browser-Impersonated JSON] → Arctic Shift RSS] → DDG]. AI는 항상 데이터, Reddit가 속도 제한 또는 자격 증명이 누락 될 때.

이 페이지는 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" ] } } }