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 |
| Suche nach Filmen anhand des Titels, optional mit |
| Suche nach TV-Sendungen anhand des Titels. |
| Vollständige Filmdetails mit Hauptbesetzung, Regisseuren und Trailer. |
| TMDB-Empfehlungen für einen Film. |
| Filme, die einem bestimmten Film ähnlich sind. |
| Trend-Inhalte ( |
| Streaming- / Verleih- / Kaufanbieter für einen Film (Standardland |
| 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
Erstellen Sie ein kostenloses Konto unter https://www.themoviedb.org/.
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 build3. Umgebung konfigurieren
Kopieren Sie .env.example nach .env und fügen Sie Ihr Token ein:
cp .env.example .envTMDB_API_KEY=eyJhbGciOi...your_v4_read_access_token...4. Server ausführen
npm startDer 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.jsonWindows:
%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 |
| Kompiliert TypeScript nach |
| Führt den kompilierten Server aus ( |
| 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/listabgerufen und im Arbeitsspeicher zwischengespeichert.Poster-URLs verwenden
https://image.tmdb.org/t/p/w500.Keine Datenbank, kein Logging-Framework — beabsichtigt.
Available Tools
8 toolsdiscover_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).
get_trendingC
Get trending movies, TV shows, or both.
Inputs: media_type (required), time_window (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
Scored across 8 tools
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.
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.
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.
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
Related MCP Connectors
Unofficial Movies MCP — wraps iTunes Search API (movies, free, no auth) and TVmaze API (TV shows…
Unlock a world of television with the TV Maze MCP server. Effortlessly search for shows by name or
OMDb MCP — IMDB-derived movie / TV / episode data (BYO key)
Related MCP Servers
- AlicenseDqualityDmaintenanceAn 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.5MIT
- AlicenseAqualityDmaintenanceA MCP server for The Movie Database API that enables AI assistants to search and retrieve movie, TV show, and person information.2313 npm4MIT
- FlicenseAqualityDmaintenanceAn 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-
- FlicenseNot gradedqualityCmaintenanceA robust MCP server that wraps The Movie Database API, enabling LLMs to search movies, get details, popular movies, and recommendations.-