TMDB MCP-Server

Dieser MCP-Server ist in die API der Movie Database (TMDB) integriert, um Filminformationen, Suchfunktionen und Empfehlungen bereitzustellen.

Voraussetzungen

Stellen Sie vor der Installation und Ausführung des TMDB MCP-Servers sicher, dass die folgenden Voraussetzungen installiert und konfiguriert sind:

Erforderliche Software

• Node.js

  • Version 18.0.0 oder höher

  • Download von der offiziellen Node.js-Website

  • Installation überprüfen: node --version

• npm (Node-Paketmanager)

  • Version 8.0.0 oder höher (wird mit Node.js geliefert)

  • Installation überprüfen: npm --version

• Typoskript

  • Wird als Projektabhängigkeit installiert

  • Kann global installiert werden: npm install -g typescript

  • Installation überprüfen: tsc --version

Erforderliche Konten und API-Schlüssel

• TMDB-Konto

  • Kostenloses Konto bei TMDB

  • API-Schlüssel vom TMDB-Dashboard

  • Der API-Zugriff muss von TMDB genehmigt werden

• Claude Desktop-Anwendung

  • Neueste installierte Version

  • Zugriff zum Ändern von Konfigurationsdateien

Systemanforderungen

• Betriebssysteme

  • macOS (10.15 oder höher)

  • Linux (moderne Distributionen)

• Hardwareanforderungen

  • Mindestens 4 GB RAM

  • 1 GB freier Speicherplatz

  • Stabile Internetverbindung

Entwicklungsumgebung

Für ein optimales Entwicklungserlebnis empfehlen wir:

• Ein Code-Editor mit TypeScript-Unterstützung (z. B. VS Code)

• Terminalzugang

• Git (zur Versionskontrolle)

Merkmale

Werkzeuge

• Filme suchen

  • Suchen Sie nach Filmen nach Titel oder Schlüsselwörtern

  • Eingabe: query (Zeichenfolge): Suchanfrage

  • Rückgabe: Liste der Filme mit Titeln, Erscheinungsjahren, IDs, Bewertungen und Übersichten

  • Beispiel: Suche nach Filmen über die Erforschung des Weltraums

• Empfehlungen abrufen

  • Erhalten Sie Filmempfehlungen basierend auf einer Film-ID

  • Eingabe: movieId (Zeichenfolge): TMDB-Film-ID

  • Renditen: Top 5 empfohlene Filme mit Details

  • Beispiel: Empfehlungen basierend auf der Film-ID 550 (Fight Club) erhalten

• get_trending

  • Holen Sie sich angesagte Filme für ein bestimmtes Zeitfenster

  • Eingabe: timeWindow (Zeichenfolge): Entweder „Tag“ oder „Woche“

  • Renditen: Top 10 der Trendfilme mit Details

  • Beispiel: Holen Sie sich die aktuellen Trendfilme

Ressourcen

Der Server bietet Zugriff auf TMDB-Filminformationen:

• Filme ( tmdb:///movie/<movie_id> )

  • Umfassende Filmdetails, darunter:

    • Titel und Erscheinungsdatum

    • Bewertung und Übersicht

    • Genres

    • Poster-URL

    • Besetzungsinformationen (Top 5 Schauspieler)

    • Direktor

    • Ausgewählte Rezensionen

  • Alle Daten werden im JSON-Format zurückgegeben

Erste Schritte

1. Holen Sie sich einen TMDB-API-Schlüssel:

   • Registrieren Sie sich bei TMDB

   • Gehen Sie zu Ihren Kontoeinstellungen

   • Navigieren Sie zum API-Bereich

   • Fordern Sie einen API-Schlüssel für die Verwendung durch Entwickler an

2. Klonen und richten Sie das Projekt ein:

   git clone [repository-url] cd mcp-server-tmdb npm install

3. Erstellen Sie den Server:

   npm run build

4. Richten Sie Ihre Umgebungsvariable ein:

   export TMDB_API_KEY=your_api_key_here

Verwendung mit Claude Desktop

Um diesen Server in Claude Desktop zu integrieren, fügen Sie der Serverkonfigurationsdatei Ihrer App (zu finden unter ~/Library/Application Support/Claude/config.json ) Folgendes hinzu:

Ersetzen Sie /full/path/to durch den tatsächlichen Pfad zu Ihrem Projektverzeichnis.

Installation über Smithery

So installieren Sie den TMDB-Server für Claude Desktop automatisch über Smithery :

Beispielverwendung

Sobald der Server mit Claude Desktop läuft, können Sie Befehle wie die folgenden verwenden:

1. Suche nach Filmen:

   "Search for movies about artificial intelligence"

2. Holen Sie sich angesagte Filme:

   "What are the trending movies today?" "Show me this week's trending movies"

3. Holen Sie sich Filmempfehlungen:

   "Get movie recommendations based on movie ID 550"

4. Filmdetails abrufen:

   "Tell me about the movie with ID 550"

Fehlerbehandlung

Der Server beinhaltet eine umfassende Fehlerbehandlung für:

• Ungültige API-Schlüssel

• Netzwerkfehler

• Ungültige Film-IDs

• Fehlerhafte Anfragen

Fehlermeldungen werden in einem benutzerfreundlichen Format über Claude Desktop zurückgegeben.

Entwicklung

So achten Sie während der Entwicklung auf Änderungen:

Lizenz

Dieser MCP-Server ist unter der MIT-Lizenz lizenziert. Weitere Informationen finden Sie in der Datei LICENSE.

Beitragen

Beiträge sind willkommen! Senden Sie gerne einen Pull Request.