Overseerr MCP Server

# Overseerr MCP Server Ein Model Context Protocol (MCP) Server für Overseerr, der es ermöglicht, Overseerr-Funktionen über Claude und andere kompatible AI-Assistenten zu nutzen. ## Features - **Medien suchen**: Filme und TV-Serien in der TMDB-Datenbank suchen - **Anfragen verwalten**: Alle Medienanfragen anzeigen, filtern und sortieren - **Medien anfordern**: Neue Filme oder TV-Serien anfordern - **Anfragen genehmigen**: Ausstehende Anfragen genehmigen - **Anfragen ablehnen**: Anfragen mit Begründung ablehnen - **Mediendetails**: Detaillierte Informationen zu Filmen/Serien abrufen - **Server-Status**: Overseerr-Server-Status und -Informationen anzeigen - **Benutzeranfragen**: Anfragen für spezifische Benutzer anzeigen ## Installation 1. **Repository klonen oder Code kopieren** ```bash mkdir overseerr-mcp-server cd overseerr-mcp-server ``` 2. **Dateien erstellen**: Kopieren Sie den TypeScript-Code in `src/index.ts` und die anderen Konfigurationsdateien 3. **Dependencies installieren** ```bash npm install ``` 4. **Build erstellen** ```bash npm run build ``` ## Konfiguration ### Umgebungsvariablen Erstellen Sie eine `.env` Datei oder setzen Sie die folgenden Umgebungsvariablen: ```bash # Erforderlich: Overseerr API Key OVERSEERR_API_KEY=your_api_key_here # Optional: Overseerr Base URL (Standard: http://localhost:5055) OVERSEERR_BASE_URL=http://localhost:5055 ``` ### API Key erhalten 1. Öffnen Sie Ihre Overseerr-Weboberfläche 2. Gehen Sie zu **Settings** → **General** 3. Scrollen Sie zu **API Key** und kopieren Sie den Schlüssel 4. Setzen Sie diesen als `OVERSEERR_API_KEY` Umgebungsvariable ### Claude Desktop Integration Fügen Sie in Ihrer Claude Desktop Konfiguration (`claude_desktop_config.json`) hinzu: ```json { "mcpServers": { "overseerr": { "command": "node", "args": ["path/to/overseerr-mcp-server/build/index.js"], "env": { "OVERSEERR_API_KEY": "your_api_key_here", "OVERSEERR_BASE_URL": "http://localhost:5055" } } } } ``` ## Verfügbare Tools ### `search_media` Sucht nach Filmen und TV-Serien ``` Parameter: - query (string): Suchbegriff - page (number, optional): Seitenzahl für Paginierung ``` ### `get_requests` Zeigt alle Medienanfragen an ``` Parameter: - take (number, optional): Anzahl Ergebnisse (Standard: 20) - skip (number, optional): Übersprungene Ergebnisse (Standard: 0) - filter (string, optional): Filter nach Status (all, approved, denied, pending, processing, available) - sort (string, optional): Sortierung (added, modified) ``` ### `request_media` Fordert ein Medium an ``` Parameter: - mediaId (number): TMDB ID des Mediums - mediaType (string): "movie" oder "tv" - seasons (array, optional): Staffeln für TV-Serien - is4k (boolean, optional): 4K-Version anfordern ``` ### `approve_request` Genehmigt eine Anfrage ``` Parameter: - requestId (number): ID der zu genehmigenden Anfrage ``` ### `deny_request` Lehnt eine Anfrage ab ``` Parameter: - requestId (number): ID der abzulehnenden Anfrage - reason (string, optional): Ablehnungsgrund ``` ### `get_media_details` Zeigt detaillierte Medieninformationen ``` Parameter: - mediaType (string): "movie" oder "tv" - mediaId (number): TMDB ID ``` ### `get_server_status` Zeigt Server-Status und -Informationen ``` Parameter: keine ``` ### `get_user_requests` Zeigt Anfragen für einen bestimmten Benutzer ``` Parameter: - userId (number): Benutzer-ID - take (number, optional): Anzahl Ergebnisse - skip (number, optional): Übersprungene Ergebnisse ``` ## Beispiel-Nutzung Nach der Installation können Sie Claude fragen: - "Suche nach dem Film 'Inception'" - "Zeige mir alle ausstehenden Medienanfragen" - "Fordere den Film 'The Matrix' an" - "Genehmige die Anfrage mit ID 123" - "Zeige mir den Status des Overseerr-Servers" ## Entwicklung Für die Entwicklung können Sie den Dev-Modus verwenden: ```bash npm run dev ``` ## Troubleshooting ### Häufige Probleme 1. **"OVERSEERR_API_KEY environment variable is required"** - Stellen Sie sicher, dass die Umgebungsvariable `OVERSEERR_API_KEY` gesetzt ist 2. **Verbindungsfehler** - Überprüfen Sie, ob Overseerr läuft und unter der konfigurierten URL erreichbar ist - Standardmäßig läuft Overseerr auf Port 5055 3. **API-Fehler** - Überprüfen Sie, ob der API Key korrekt ist - Stellen Sie sicher, dass der Benutzer die nötigen Berechtigungen hat ### Debug-Modus Für erweiterte Debugging-Informationen können Sie die Logs überprüfen: ```bash # Server direkt ausführen für Logs node build/index.js ``` ## Lizenz MIT License - siehe LICENSE Datei für Details.