mcp-server-tmdb

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.