Reddit MCP Server

Ein Model Context Protocol (MCP)-Server für die Interaktion mit Reddit – Beiträge, Kommentare, Benutzerinformationen abrufen und Inhalte erstellen.

Funktionen auf einen Blick

Related MCP server: Reddit MCP Server

Schnellstart

Option 1: Claude Desktop-Erweiterung (am einfachsten)

Laden Sie die Erweiterungsdatei herunter und öffnen Sie sie – Claude Desktop installiert sie automatisch:

reddit-mcp-server.mcpb herunterladen

Option 2: NPX (keine Installation erforderlich)

npx reddit-mcp-server

Oder fügen Sie es zu Ihrer MCP-Konfiguration hinzu (Claude Desktop, Cursor usw.):

{
  "mcpServers": {
    "reddit": {
      "command": "npx",
      "args": ["reddit-mcp-server"]
    }
  }
}

Option 3: Claude Code

claude mcp add --transport stdio reddit -- npx reddit-mcp-server

Funktionen

Schreibgeschützte Tools

Schreib-Tools (erfordern Benutzeranmeldedaten)

Konfiguration

Umgebungsvariablen

*Nur erforderlich, wenn der Modus authenticated verwendet wird.

Vollständiges MCP-Konfigurationsbeispiel

{
  "mcpServers": {
    "reddit": {
      "command": "npx",
      "args": ["reddit-mcp-server"],
      "env": {
        "REDDIT_CLIENT_ID": "your_client_id",
        "REDDIT_CLIENT_SECRET": "your_client_secret",
        "REDDIT_USERNAME": "your_username",
        "REDDIT_PASSWORD": "your_password",
        "REDDIT_SAFE_MODE": "standard"
      }
    }
  }
}

Sicherheitsmodus (Spam-Schutz)

Schützen Sie Ihr Reddit-Konto mit integrierten Schutzmechanismen vor Spam-Erkennung und Sperren. Standardmäßig aktiviert (Modus standard) gemäß der Responsible Builder Policy von Reddit.

Warum der Sicherheitsmodus?

Die Spam-Erkennung von Reddit kann Konten kennzeichnen bei:

• Schnellem Posten oder Kommentieren

• Doppelten oder ähnlichen Inhalten

• Posten desselben Inhalts in mehreren Subreddits

• Nicht standardgemäßen User-Agent-Zeichenfolgen

Der Sicherheitsmodus hilft, diese Probleme automatisch zu vermeiden.

Modusoptionen

Sicherheitsmodus deaktivieren

Der Sicherheitsmodus ist standardmäßig aktiviert. So deaktivieren Sie ihn ausdrücklich:

export REDDIT_SAFE_MODE=off
npx reddit-mcp-server

Was der Sicherheitsmodus bewirkt

1. Ratenbegrenzung: Erzwingt Mindestabstände zwischen Schreibvorgängen

2. Duplikaterkennung: Verhindert, dass identische Inhalte doppelt gepostet werden

3. Subredditübergreifende Erkennung: Verhindert das Posten desselben Inhalts in mehreren Subreddits (gemäß Reddit-Richtlinien)

4. Intelligenter User-Agent: Generiert automatisch ein Reddit-konformes User-Agent-Format, wenn ein Benutzername angegeben ist

Offenlegung von Bots

Die Responsible Builder Policy von Reddit verlangt, dass Bots ihre automatisierte Natur offenlegen. Aktivieren Sie automatische Bot-Fußzeilen für alle veröffentlichten Inhalte:

export REDDIT_BOT_DISCLOSURE=auto
npx reddit-mcp-server

Wenn aktiviert, wird allen Beiträgen, Antworten und Bearbeitungen eine Fußzeile hinzugefügt:

---
🤖 I am a bot | Built with reddit-mcp-server

Passen Sie die Fußzeile mit REDDIT_BOT_FOOTER an:

export REDDIT_BOT_DISCLOSURE=auto
export REDDIT_BOT_FOOTER=$'\n\n---\n^(🤖 Custom bot footer text)'

Authentifizierungsmodi

Modusvergleich

Anonymer Modus (ohne Einrichtung)

{
  "env": {
    "REDDIT_AUTH_MODE": "anonymous"
  }
}

Der anonyme Modus funktioniert nicht in jedem Netzwerk. Reddit blockiert nicht authentifizierte Anfragen aus vielen IP-Bereichen – Rechenzentren, Cloud-Hosts, VPNs und Adressen, die es gekennzeichnet hat – und antwortet mit einer HTTP-403-Sperrseite. Wenn dies passiert, schlagen Tools mit folgender Meldung fehl:

Reddit is blocking unauthenticated requests from this network (HTTP 403 with a
block page). Set REDDIT_CLIENT_ID and REDDIT_CLIENT_SECRET to authenticate with
OAuth, which also raises the rate limit from ~10 to 60+ requests/min.

Die Lösung sind OAuth-Anmeldedaten – siehe nächster Abschnitt. Dies ist eine Eigenschaft Ihres Netzwerks, nicht Ihres Reddit-Kontos oder des angeforderten Subreddits, und betrifft daher alle Tools gleichzeitig. Ein 403-Fehler bei einem einzelnen Subreddit, während andere funktionieren, ist etwas anderes: Dieser Subreddit ist privat oder gesperrt.

Authentifizierter Modus (höhere Ratengrenzen)

1. Erstellen Sie eine Reddit-App unter https://www.reddit.com/prefs/apps (wählen Sie den Typ „script“)

2. Kopieren Sie Client-ID und Geheimnis

3. Konfigurieren Sie:

{
  "env": {
    "REDDIT_AUTH_MODE": "authenticated",
    "REDDIT_CLIENT_ID": "your_client_id",
    "REDDIT_CLIENT_SECRET": "your_client_secret"
  }
}

Schreibvorgänge

Zum Erstellen von Beiträgen, Antworten, Bearbeiten oder Löschen von Inhalten benötigen Sie Benutzeranmeldedaten:

{
  "env": {
    "REDDIT_USERNAME": "your_username",
    "REDDIT_PASSWORD": "your_password",
    "REDDIT_SAFE_MODE": "standard"
  }
}

Entwicklung

Befehle

pnpm install        # Install dependencies
pnpm build          # Build TypeScript
pnpm dev            # Build and run MCP inspector
pnpm test           # Run tests
pnpm lint           # Lint code
pnpm format         # Format code

CLI-Optionen

npx reddit-mcp-server --version         # Show version
npx reddit-mcp-server --help            # Show help
npx reddit-mcp-server --generate-token  # Generate OAuth token for HTTP mode

HTTP-Servermodus

Für Docker-Bereitstellungen oder webbasierte Clients verwenden Sie den HTTP-Transport:

TRANSPORT_TYPE=httpStream PORT=3000 node dist/index.js

Mit OAuth-Schutz

export OAUTH_ENABLED=true
export OAUTH_TOKEN=$(npx reddit-mcp-server --generate-token | tail -1)
TRANSPORT_TYPE=httpStream node dist/index.js

Authentifizierte Anfragen stellen:

curl -H "Authorization: Bearer $OAUTH_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"method":"tools/list","params":{}}' \
     http://localhost:3000/mcp

Docker

Schnellstart

# Pull and run
docker pull ghcr.io/jordanburke/reddit-mcp-server:latest

docker run -d \
  --name reddit-mcp \
  -p 3000:3000 \
  -e REDDIT_CLIENT_ID=your_client_id \
  -e REDDIT_CLIENT_SECRET=your_client_secret \
  -e REDDIT_SAFE_MODE=standard \
  ghcr.io/jordanburke/reddit-mcp-server:latest

Docker Compose

services:
  reddit-mcp:
    image: ghcr.io/jordanburke/reddit-mcp-server:latest
    ports:
      - "3000:3000"
    environment:
      - REDDIT_CLIENT_ID=${REDDIT_CLIENT_ID}
      - REDDIT_CLIENT_SECRET=${REDDIT_CLIENT_SECRET}
      - REDDIT_USERNAME=${REDDIT_USERNAME}
      - REDDIT_PASSWORD=${REDDIT_PASSWORD}
      - REDDIT_SAFE_MODE=standard
      - OAUTH_ENABLED=${OAUTH_ENABLED:-false}
      - OAUTH_TOKEN=${OAUTH_TOKEN}
    restart: unless-stopped

Lokal erstellen

docker build -t reddit-mcp-server .
docker run -d --name reddit-mcp -p 3000:3000 --env-file .env reddit-mcp-server

Reddit Responsible Builder Policy

Dieser Server wurde im Hinblick auf die Responsible Builder Policy von Reddit entwickelt:

• Sicherheitsmodus standardmäßig aktiviert – Ratenbegrenzung und Duplikaterkennung verhindern Spam

• Subredditübergreifende Duplikaterkennung – blockiert identische Inhalte über Subreddits hinweg

• Unterstützung der Bot-Offenlegung – optionale automatisierte Fußzeile für Transparenz

• Keine Manipulation von Abstimmungen/Karma – Upvote-/Downvote-Tools sind bewusst ausgeschlossen

• Keine privaten Nachrichten – DM-Tools sind bewusst ausgeschlossen

• Richtlinienbewusste KI-Anweisungen – MCP-Serveranweisungen erinnern KI-Assistenten an die Beschränkungen der Datennutzung

Danksagungen

• Fork von reddit-mcp-server von Alexandros Lekkas

• Inspiriert von Python Reddit MCP Server von Arindam200