Skip to main content
Glama
moviefinder-mcp

moviefinder-mcp

moviefinder-mcp

Ein MCP-Server, der die API von The Movie Database (TMDB) umschließt. Erstellt mit @modelcontextprotocol/sdk und stdio-Transport.

Tools

Tool

Beschreibung

search_movies

Suche nach Filmen anhand des Titels, optional mit year-Filter.

search_tv

Suche nach TV-Sendungen anhand des Titels.

get_movie_details

Vollständige Filmdetails mit Hauptbesetzung, Regisseuren und Trailer.

get_recommendations

TMDB-Empfehlungen für einen Film.

get_similar

Filme, die einem bestimmten Film ähnlich sind.

get_trending

Trend-Inhalte (movie / tv / all) für day oder week.

where_to_stream

Streaming- / Verleih- / Kaufanbieter für einen Film (Standardland US).

discover_movies

Entdecken nach Genre-Name, Mindestbewertung, Jahr und Sortierreihenfolge.

Alle Tools geben zusammengefasstes JSON zurück (ID, Titel, Jahr, Übersicht, Bewertung, Poster-URL usw.) — die überflüssigen TMDB-Rohdaten werden entfernt.

Related MCP server: wizzy-mcp-tmdb

Einrichtung

1. TMDB-API-Token abrufen

  1. Erstellen Sie ein kostenloses Konto unter https://www.themoviedb.org/.

  2. Besuchen Sie https://www.themoviedb.org/settings/api und kopieren Sie das API Read Access Token (v4). Dies ist ein langes JWT — es ist nicht der v3-API-Schlüssel.

2. Installieren und bauen

npm install
npm run build

3. Umgebung konfigurieren

Kopieren Sie .env.example nach .env und fügen Sie Ihr Token ein:

cp .env.example .env
TMDB_API_KEY=eyJhbGciOi...your_v4_read_access_token...

4. Server ausführen

npm start

Der Server kommuniziert über stdio mittels MCP und ist dafür gedacht, von einem MCP-Client (wie Claude Desktop) gestartet zu werden, nicht um interaktiv ausgeführt zu werden.

Registrierung bei Claude Desktop

Fügen Sie einen Eintrag in claude_desktop_config.json hinzu:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "moviefinder": {
      "command": "node",
      "args": ["/absolute/path/to/moviefinder-mcp/dist/index.js"],
      "env": {
        "TMDB_API_KEY": "eyJhbGciOi...your_v4_read_access_token..."
      }
    }
  }
}

Starten Sie Claude Desktop nach dem Bearbeiten der Konfiguration neu. Die moviefinder-Tools erscheinen dann in jeder Unterhaltung.

Skripte

Skript

Was es tut

npm run build

Kompiliert TypeScript nach dist/.

npm start

Führt den kompilierten Server aus (node dist/index.js).

npm run dev

TypeScript-Watch-Modus.

Fehlerbehandlung

Der Server gibt hilfreiche Meldungen für häufige TMDB-Fehler zurück:

  • 401 — Token fehlt oder falscher Schlüsseltyp (muss ein v4 Read Access Token sein).

  • 404 — der angeforderte Film / die Ressource existiert nicht.

  • 429 — Ratenbegrenzung erreicht; der Retry-After-Wert wird einbezogen, falls vorhanden.

Hinweise

  • Die Genre-Liste wird einmalig von /genre/movie/list abgerufen und im Arbeitsspeicher zwischengespeichert.

  • Poster-URLs verwenden https://image.tmdb.org/t/p/w500.

  • Keine Datenbank, kein Logging-Framework — beabsichtigt.

Available Tools

8 tools
discover_moviesC

Discover movies by genre name, minimum rating, year, and sort order. Genre is resolved by name (e.g. 'Action').

Inputs: genre, min_rating, year, sort_by.

get_movie_detailsA

Get full details for a movie, including top cast, directors, and trailer.

Inputs: movie_id (required).

get_recommendationsC

Get TMDB recommendations for a given movie.

Inputs: movie_id (required).

get_similarC

Get movies similar to a given movie.

Inputs: movie_id (required).

search_moviesA

Search TMDB for movies by title. Optionally filter by release year.

Inputs: query (required), year.

search_tvB

Search TMDB for TV shows by title.

Inputs: query (required).

where_to_streamA

Find streaming, rental, and purchase providers for a movie in a given country (default US). Data sourced from JustWatch via TMDB.

Inputs: movie_id (required), country_code.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 8 tools

    Disambiguation5/5

    Each tool targets a distinct action: discover by criteria, get full details, get recommendations, get similar, get trending, search movies, search TV, and find streaming providers. No meaningful overlap exists.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun snake_case pattern (e.g., discover_movies, get_movie_details, search_tv). 'where_to_stream' is a minor deviation but still clearly readable.

    Tool Count5/5

    8 tools cover the main use cases for a movie/TV finder: discovery, search, details, trends, recommendations, similar, and streaming info. The scope is well-balanced.

    Completeness4/5

    The set covers most core movie operations, but lacks get_tv_details for TV shows. Other gaps like user ratings or reviews are acceptable for the stated purpose.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      D
      quality
      D
      maintenance
      An MCP server that allows users to search for movies, get detailed information, receive genre-based recommendations, and discover popular/trending films using OMDb and TMDb APIs.
      5
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      A MCP server for The Movie Database API that enables AI assistants to search and retrieve movie, TV show, and person information.
      23
      13 npm
      4
      MIT
    • F
      license
      A
      quality
      D
      maintenance
      An MCP server that wraps the TMDB API, enabling search of movies and TV shows, retrieval of details, trending titles, recommendations, and streaming provider information.
      8
      -
    • F
      license
      Not graded
      quality
      C
      maintenance
      A robust MCP server that wraps The Movie Database API, enabling LLMs to search movies, get details, popular movies, and recommendations.
      -