reddit-mcp

Ein schreibgeschützter Model Context Protocol-Server, der die Reddit-API für das Durchsuchen von Subreddits, die Suche innerhalb von Subreddits, das Abrufen von Kommentarstrukturen und das Nachschlagen von Benutzeraktivitäten kapselt. Gedacht für die persönliche Verfolgung von r/homelabsales, r/hardwareswap und ähnlichen Subreddits über Claude Code und Claude Desktop. In Python geschrieben, läuft lokal über stdio.

Auth-Stufen (alle optional)

Der Server erkennt automatisch, welche der drei Stufen verwendet werden soll, basierend auf den von Ihnen gesetzten Umgebungsvariablen:

Neue Benutzer: Beginnen Sie mit der anonymen Stufe. Reddit hat die Self-Service-Erstellung von API-Schlüsseln im November 2025 beendet (Responsible Builder Policy), daher erfordert der Erhalt von OAuth-Anmeldedaten jetzt eine Genehmigung, die persönliche Skripte normalerweise ablehnt. Die anonyme Stufe deckt jeden Lesepfad ab, den dieser Server implementiert. Siehe Abschnitt 3.2 in docs/design.md für die vollständige Geschichte.

Related MCP server: Reddit MCP Server

Plugin-Installation (lokale Entwicklung)

Das gesamte Repo ist ein Claude Code-Plugin (Skill + Slash-Befehle + MCP-Server gebündelt). Um es lokal auszuprobieren:

cd /Users/conrad/Ai/reddit_mcp
uv pip install -e .                                          # one-time, sets up the MCP server in a venv
claude plugin marketplace add /Users/conrad/Ai/reddit_mcp    # register this repo as a local marketplace
claude plugin install reddit-deal-hunter@reddit-mcp-local    # install + enable the plugin

Starten Sie Claude Code neu. Bei der ersten MCP-Aktivierung werden Sie nach fünf Feldern gefragt (reddit_user_agent, reddit_client_id, reddit_client_secret, reddit_username, reddit_password), die alle optional sind. Lassen Sie eines oder alle leer, um auf einer niedrigeren Stufe zu bleiben. Das Setzen von reddit_user_agent wird unabhängig von der Stufe empfohlen; verwenden Sie das Format macos:reddit-mcp:0.2 (by /u/yourusername).

Sobald aktiviert, stehen der Skill, die Befehle /reddit-deal-hunter:scan und /reddit-deal-hunter:thread-check sowie alle vier MCP-Tools (get_subreddit_posts, search_subreddit, get_post_details, user_analysis) zur Verfügung.

Hinweis: Seit April 2026 bindet die MCP-Ebene des Plugin-Bundles die Tools möglicherweise nicht bei jeder Installation an Claude Code-Sitzungen an (inline mcpServers in plugin.json ist als unterstützt dokumentiert, aber das GUI-Laufzeitverhalten variiert). Wenn der Skill und die Slash-Befehle erscheinen, aber die mcp__reddit_mcp__*-Tools nicht, greifen Sie auf den unten stehenden MCP-only-Installationspfad zurück. Siehe docs/tool-ux-findings.md und HANDOFF.md (Sitzung 5 Nachtrag) für Details.

Manuelle Installation (nur MCP, kein Plugin) — derzeit der zuverlässigste Pfad

Wenn Sie nur den MCP-Server möchten (kein Skill, keine Slash-Befehle) oder wenn die oben genannte Plugin-Ebenen-Installation die MCP-Tools nicht an Ihre Sitzung anhängt, registrieren Sie ihn direkt im Benutzerbereich bei Claude Code:

cd /Users/conrad/Ai/reddit_mcp
uv venv --python 3.12
uv pip install -e .

# Anonymous (zero credentials):
claude mcp add reddit_mcp \
  --scope user \
  --env REDDIT_USER_AGENT="macos:reddit-mcp:0.2 (by /u/yourusername)" \
  -- uv run --directory /Users/conrad/Ai/reddit_mcp reddit-mcp

# OAuth app-only (add client creds):
claude mcp add reddit_mcp \
  --scope user \
  --env REDDIT_USER_AGENT="macos:reddit-mcp:0.2 (by /u/yourusername)" \
  --env REDDIT_CLIENT_ID=YOUR_REDDIT_CLIENT_ID \
  --env REDDIT_CLIENT_SECRET=YOUR_REDDIT_CLIENT_SECRET \
  -- uv run --directory /Users/conrad/Ai/reddit_mcp reddit-mcp

Überprüfen Sie dies mit claude mcp list (erwarten Sie reddit_mcp ✓ Connected) und starten Sie Claude Code neu, damit die Tools an neue Sitzungen angehängt werden.

Siehe Abschnitt 7 in docs/design.md für die Registrierung bei Claude Desktop und andere Client-Verbindungen.

Repo-Layout

reddit-mcp/
├── .claude-plugin/
│   ├── plugin.json                 # plugin manifest + inline mcpServers block
│   └── marketplace.json            # single-plugin local-marketplace descriptor
├── CLAUDE.md                       # repo-specific working notes for Claude Code
├── commands/                       # user-invoked slash commands
│   ├── scan.md                     # /reddit-deal-hunter:scan <query>
│   └── thread-check.md             # /reddit-deal-hunter:thread-check <permalink-or-id>
├── docs/
│   ├── design.md                   # full design, the authoritative read
│   ├── supply-chain-baseline.md    # pinned-deps audit baseline
│   └── tool-ux-findings.md         # known issues surfaced by the live eval run
├── evals/
│   └── reddit_eval.xml             # 10 qa_pairs for mcp-builder evaluation
├── pyproject.toml                  # mcp, httpx (pinned)
├── reddit_mcp.py                   # the MCP server (uses mcp SDK FastMCP)
├── skills/
│   └── deal-hunter/SKILL.md        # model-invoked deal-watching heuristics
└── tests/test_smoke.py             # module import + tool registration

Status

Vor-v1. Die anonyme Stufe funktioniert von Anfang bis Ende ohne Anmeldedaten (live validiert gegen Reddit; 10/10 eval-suite bestanden). OAuth-Upgrade-Pfade funktionieren, falls Sie Anmeldedaten haben. Verbleibende v1-Arbeit: ein Refactoring der Tool-Antwort-Projektion, nachverfolgt in docs/tool-ux-findings.md. Öffentliche Veröffentlichung nach v1-Validierung.

Siehe docs/design.md für das vollständige Design und die Begründung, CLAUDE.md für die Arbeitsnotizen-Version und HANDOFF.md für die Übergabe von Sitzung zu Sitzung.

Lizenz

MIT.