Reddit Content API – Einrichtungs- und Nutzungshandbuch
Dieses Projekt bietet MCP-Tools (Model Context Protocol) für die Interaktion mit Reddit über Claude und Cursor.
Merkmale
- Lesen von Trendbeiträgen aus Subreddits
- Reddit-Diskussionen mit Kommentaren analysieren
- Erstellen von Beiträgen auf Reddit
- Hinzufügen von Kommentaren zu Beiträgen oder Antworten auf vorhandene Kommentare
- Abstimmen über Beiträge und Kommentare
Anforderungen
- Python 3.10+
- Ein Reddit-Konto
- Eine registrierte Reddit-Anwendung (um Client-ID und Client-Geheimnis zu erhalten)
- Virtuelle Umgebung (venv oder ähnlich)
- Claude Desktop und/oder Cursor (optional, aber empfohlen)
Installation von Grund auf
Befolgen Sie diese Schritte sorgfältig, um Import- und Konfigurationsprobleme zu vermeiden:
⚠️ WICHTIG : Installieren Sie das Paket NICHT im bearbeitbaren Modus (
pip install -e .
), da dies zu Problemen beim Modulimport führen kann.
Umgebungskonfiguration
- Erstellen Sie im Projektstammverzeichnis eine
.env
Datei mit den folgenden Variablen:
- Um ein Aktualisierungstoken zu erhalten, führen Sie Folgendes aus:
Folgen Sie den Anweisungen zur Autorisierung der Anwendung. Das Token wird automatisch in der .env
Datei gespeichert.
Projektstruktur
Direktes Ausführen des Servers
So führen Sie es manuell aus (nützlich für Entwicklung und Tests):
Sie sollten Protokolle sehen, die Folgendes anzeigen:
- Serverinitialisierung
- Reddit-Authentifizierungsüberprüfung
- Registrierung von 10 Werkzeugen (5 Original + 5 mit Präfix)
- „MCP-Server wird ausgeführt …“
Claude Desktop-Konfiguration
- Suchen Sie die Konfigurationsdatei:
- Unter macOS:
/Users/your-username/Library/Application Support/Claude/claude_desktop_config.json
- Unter Windows:
%APPDATA%\Claude\claude_desktop_config.json
- Unter macOS:
- Fügen Sie die Konfiguration für Reddit-Content-API hinzu:
⚠️ EXTREM WICHTIG :
PYTHONPATH
muss sowohl dassrc
Verzeichnis als auch das Projektstammverzeichnis in dieser Reihenfolge enthalten, getrennt durch:
(unter Unix/macOS) oder;
(unter Windows).
Cursorkonfiguration
- Suchen Sie die Konfigurationsdatei:
- Unter macOS:
/Users/your-username/.cursor/mcp.json
- Unter Windows:
%USERPROFILE%\.cursor\mcp.json
- Unter macOS:
- Fügen Sie dieselbe Konfiguration wie in Claude hinzu und passen Sie die Pfade nach Bedarf an.
Fehlerbehebung bei häufigen Problemen
Problem: Es werden nur 2 Tools angezeigt, statt der erwarteten 10
Symptome : Beim Ausführen des Servers werden nur 2 Tools anstelle der erwarteten 10 angezeigt.
Mögliche Ursachen und Lösungen :
- Importproblem : Python importiert eine installierte Version aus
site-packages
anstelle des lokalen Codes insrc/
.Lösung :- Stellen Sie sicher, dass Sie das Paket NICHT im bearbeitbaren Modus installieren (
pip install -e .
) - Fügen Sie
src
explizit am Anfang vonPYTHONPATH
in den Konfigurationen hinzu - Wenn Sie es bereits installiert haben, verwenden Sie
pip uninstall reddit-content-api
um es zu entfernen
- Stellen Sie sicher, dass Sie das Paket NICHT im bearbeitbaren Modus installieren (
- Python-Cache : Alte
.pyc
Dateien können Probleme verursachen.Lösung :- Entfernen Sie alle
__pycache__
Verzeichnisse aus dem Projekt
- Entfernen Sie alle
- Versionskonflikte : Verschiedene Versionen derselben Bibliothek.Lösung :
- Installieren Sie Abhängigkeiten mit
pip install -r requirements.txt
neu
- Installieren Sie Abhängigkeiten mit
Problem: „Beitrag kann nicht erstellt werden: Reddit-Authentifizierung ist nicht richtig konfiguriert.“
Ursache : Das Aktualisierungstoken ist ungültig oder abgelaufen.
Lösung : Generieren Sie das Token neu, indem Sie python -m mcp_reddit.auth_helper
ausführen, und stellen Sie sicher, dass es in .env
gespeichert ist.
Problem: Werkzeuge werden in Claude/Cursor nicht angezeigt
Ursache : Falsche Konfiguration in den Konfigurationsdateien.
Lösung :
- Überprüfen Sie die Pfade und insbesondere
PYTHONPATH
in den Konfigurationsdateien - Starten Sie Claude/Cursor nach der Änderung der Konfiguration vollständig neu
Verwenden der Tools in Claude/Cursor
Nach der Konfiguration können Sie die folgenden Tools verwenden:
mcp_reddit_content_api_fetch_reddit_hot_threads
– Trendbeiträge abrufenmcp_reddit_content_api_fetch_reddit_post_content
– Analysieren Sie einen Beitrag und seine Kommentaremcp_reddit_content_api_create_reddit_post
– Einen neuen Beitrag erstellenmcp_reddit_content_api_add_reddit_comment
– Einen Kommentar hinzufügenmcp_reddit_content_api_vote_on_reddit_content
– Über Inhalte abstimmen
Beispiele
Trendbeiträge erhalten :
Einen Beitrag erstellen :
Beiträge
Wenn Sie Probleme finden oder Verbesserungen haben, erstellen Sie bitte ein Problem oder senden Sie eine Pull-Anfrage.
Lizenz
Unterstützen Sie dieses Projekt
Wenn Sie dieses Projekt für Ihre Arbeit oder Forschung nützlich finden, ziehen Sie bitte Folgendes in Betracht:
- ⭐ Markieren Sie das Repository mit einem Stern, um Ihre Unterstützung zu zeigen
- 🔄 Folgen Sie dem Repository für Updates zu neuen Funktionen und Verbesserungen
- 🐛 Probleme bei Fehlern oder Funktionsanfragen melden
- 🛠️ Tragen Sie mit Pull Requests bei, wenn Sie Verbesserungen mitteilen möchten
Ihre Unterstützung trägt dazu bei, dieses Projekt für alle zu verbessern!
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
MCP-Server, der die Interaktion mit Reddit ermöglicht und es Benutzern erlaubt, Trendbeiträge zu lesen, Diskussionen zu analysieren, Beiträge zu erstellen, Kommentare hinzuzufügen und über Claude und Cursor über Inhalte abzustimmen.
Related MCP Servers
- AsecurityAlicenseAqualityAn MCP server that enables saving and sharing Claude Desktop conversations, allowing users to store chats privately or make them public through a web interface.Last updated -26TypeScriptMIT License
- AsecurityAlicenseAqualityAn MCP server that enables Claude to interact with Twitter, allowing for posting tweets and searching Twitter content.Last updated -2887228TypeScriptMIT License
- AsecurityAlicenseAqualityAn MCP server that enables posting messages to Discord webhooks, allowing customization of content, username, and avatar URL.Last updated -10JavaScriptMIT License
- -securityAlicense-qualityA MCP server that provides browser automation tools, allowing users to navigate websites, take screenshots, click elements, fill forms, and execute JavaScript through Playwright.Last updated -PythonApache 2.0