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

Repository klonen oder Code kopieren

mkdir overseerr-mcp-server cd overseerr-mcp-server

Dateien erstellen: Kopieren Sie den TypeScript-Code in src/index.ts und die anderen Konfigurationsdateien
Dependencies installieren

npm install

Build erstellen

npm run build

Konfiguration

Umgebungsvariablen

Erstellen Sie eine .env Datei oder setzen Sie die folgenden Umgebungsvariablen:

# 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

Öffnen Sie Ihre Overseerr-Weboberfläche
Gehen Sie zu Settings → General
Scrollen Sie zu API Key und kopieren Sie den Schlüssel
Setzen Sie diesen als OVERSEERR_API_KEY Umgebungsvariable

Claude Desktop Integration

Fügen Sie in Ihrer Claude Desktop Konfiguration (claude_desktop_config.json) hinzu:

{ "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:

npm run dev

Troubleshooting

Häufige Probleme

"OVERSEERR_API_KEY environment variable is required"
- Stellen Sie sicher, dass die Umgebungsvariable OVERSEERR_API_KEY gesetzt ist
Verbindungsfehler
- Überprüfen Sie, ob Overseerr läuft und unter der konfigurierten URL erreichbar ist
- Standardmäßig läuft Overseerr auf Port 5055
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:

# Server direkt ausführen für Logs node build/index.js

Lizenz

MIT License - siehe LICENSE Datei für Details.

Overseerr MCP Server

Overseerr MCP Server

Features

Installation

Konfiguration

Umgebungsvariablen

API Key erhalten

Claude Desktop Integration

Verfügbare Tools

`search_media`

`get_requests`

`request_media`

`approve_request`

`deny_request`

`get_media_details`

`get_server_status`

`get_user_requests`

Beispiel-Nutzung

Entwicklung

Troubleshooting

Häufige Probleme

Debug-Modus

Lizenz

Related Resources

New MCP Servers

MCP directory API