# mcp-server-overseerr
## 基本信息
- Slug: `edemal-mcp-server-overseerr`
- Source: modelscope
- Publisher: @edemal/mcp-server-overseerr
- Categories: entertainment-and-media / content-management-systems / app-automation
- Hosted: No
- License: Unknown
- Source URL: https://www.modelscope.cn/mcp/servers/@edemal/mcp-server-overseerr
## 简介
暂无描述。
## 安装提示

```bash
mkdir overseerr-mcp-server cd overseerr-mcp-server
```

## MCP Server 详情

# Overseerr MCP Server

Ein Model Context Protocol (MCP) Server fr Overseerr, der es ermglicht, 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 Begrndung ablehnen
- **Mediendetails**: Detaillierte Informationen zu Filmen/Serien abrufen
- **Server-Status**: Overseerr-Server-Status und -Informationen anzeigen
- **Benutzeranfragen**: Anfragen fr 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-Weboberflche
2. Gehen Sie zu **Settings**  **General**
3. Scrollen Sie zu **API Key** und kopieren Sie den Schlssel
4. Setzen Sie diesen als `OVERSEERR_API_KEY` Umgebungsvariable

### Claude Desktop Integration

Fgen 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"
      }
    }
  }
}
```

## Verfgbare Tools

### `search_media`
Sucht nach Filmen und TV-Serien
```
Parameter:
- query (string): Suchbegriff
- page (number, optional): Seitenzahl fr 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 fr 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 fr einen bestimmten Benutzer
```
Parameter:
- userId (number): Benutzer-ID
- take (number, optional): Anzahl Ergebnisse
- skip (number, optional): bersprungene Ergebnisse
```

## Beispiel-Nutzung

Nach der Installation knnen 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

Fr die Entwicklung knnen Sie den Dev-Modus verwenden:

```bash
npm run dev
```

## Troubleshooting

### Hufige Probleme

1. **"OVERSEERR_API_KEY environment variable is required"**
   - Stellen Sie sicher, dass die Umgebungsvariable `OVERSEERR_API_KEY` gesetzt ist

2. **Verbindungsfehler**
   - berprfen Sie, ob Overseerr luft und unter der konfigurierten URL erreichbar ist
   - Standardmig luft Overseerr auf Port 5055

3. **API-Fehler**
   - berprfen Sie, ob der API Key korrekt ist
   - Stellen Sie sicher, dass der Benutzer die ntigen Berechtigungen hat

### Debug-Modus

Fr erweiterte Debugging-Informationen knnen Sie die Logs berprfen:

```bash
# Server direkt ausfhren fr Logs
node build/index.js
```

## Lizenz

MIT License - siehe LICENSE Datei fr Details.