ムービーデータベース(TMDB) API 用の MCP サーバー。 映画やテレビの検索、ストリーミングの可用性、キャスト、乗務員の詳細、およびCodexやClaudeデスクトップなどのアシスタントの推奨事項を提供します。

再利用可能なMCPサーバーと高レベルの機能ワークフロー間でアーキテクチャが分割されるため、USERGUIDE.mdを参照してください。

ツール

##ムービーディスカバリー

• get weekend watchlist — 気分、国、言語、ランタイム、評価、サービスで週末のショートリストをランクイン
• plan watch party — プライマリピック、バックアップ、ワイルドカード、パーティーフィットの理由、プロバイダーの可用性、および回避されたタイトルフィルタリングによるグループムービーナイトプラン
• build franchise watch order — Franchise/universe リリースオーダー、提案された注文、合計ランタイム、およびprovider-aware ノート
• build collection gap plan — フランチャイズの補完計画を監視/従順なエントリ、残りのランタイム、プロバイダーの可用性、および完了パス
• recommend from taste profile — provider-aware scoring、マッチ理由、および注意を伴ったようなタイトルからの推奨事項
• build release calendar watchlist — リリースウィンドウのウォッチリストで、今後の映画、提供者準備ができているピック、広間ベースライン、および腕時計ラタースコアリング

TMDB MCP Server

An MCP server for The Movie Database (TMDB) API. It provides movie and TV search, streaming availability, cast and crew details, and recommendations for assistants such as Codex and Claude Desktop.

For the architecture split between the reusable MCP server and higher-level feature workflows, see USERGUIDE.md.

Tools

Movie Discovery

• get_weekend_watchlist — Ranked weekend shortlist by mood, country, language, runtime, rating, and services
• plan_watch_party — Group movie-night plan with a primary pick, backup, wildcard, party-fit reasons, provider availability, and avoided-title filtering
• build_franchise_watch_order — Franchise/universe guide with release order, suggested order, total runtime, and provider-aware notes
• build_collection_gap_plan — Franchise completion plan with watched/missing entries, remaining runtime, provider availability, and completion path
• recommend_from_taste_profile — Recommendations from liked/disliked titles with provider-aware scoring, match reasons, and cautions
• build_release_calendar_watchlist — Release-window watchlist with upcoming movies, provider-ready picks, broad-room baselines, and watch-later scoring
• search_movies — Search by title/keywords → titles, IDs, ratings, overviews
• get_trending — Top 10 trending movies (timeWindow: “day” | “week”)
• get_weekly_trending_by_language — Weekly trending movies grouped by original language into English, Hindi, and Telugu
• search_by_genre — Movies by genre name, optional year filter
• advanced_search — Filter by genre, year, min rating, sort, language
• search_by_keyword — Find movies by theme/keyword (e.g. “zombie”, “heist”)

Movie Details

• get_movie_details — Full details: cast, crew, runtime, genres, reviews (by movieId)
• compare_movies — Side-by-side comparison for 2-5 movie IDs with ratings, runtime, cast, director, providers, and best-fit notes
• get_recommendations — Top 5 recommendations based on a movie ID
• get_similar_movies — Similar movies via TMDB’s similarity algorithm
• get_watch_providers — Streaming/rental/purchase availability by country (default: IN)
• find_where_to_watch — Search 1-5 movie titles and return streaming/rental/purchase availability with preferred-service matches

TV Shows

• search_tv_shows — Search TV series by title
• get_trending_tv — Top 10 trending TV shows (timeWindow: “day” | “week”)

People

• search_person — Find actors, directors, crew by name → ID + known works
• get_person_details — Full bio + filmography (movies + TV) by personId
• build_person_watch_path — Actor/director watch path with best-rated, available-now, recent, and starter picks

Resources

• tmdb:///movie/ — Full movie details in JSON (title, cast, director, reviews, poster URL)

Quick Start

1. Get a TMDB API key at themoviedb.org → Account Settings → API