TMDB MCP Server

TMDB MCP サーバー

The Movie Database （TMDB）用のMCPサーバーです。映画、テレビ番組、人物を検索・参照でき、同じ呼び出しでOMDb経由のIMDb／Rotten Tomatoes／Metacriticの評価も取得できます。

このサーバーは標準的なMCP over stdioに対応しているため、あらゆるMCPクライアント（Claude Desktop／Code、Cursor、VS Code、Cline、…）で動作します。

接続したら、エージェントに自然言語で尋ねるだけです（無料のTMDBトークンが必要です。認証情報の取得をご覧ください）。

"Search for the movie Dune: Part Two and show its overview, genres and runtime."
"What movies are trending this week?"
"Find TV shows similar to Breaking Bad."
"Who directed Oppenheimer? Show the main cast."
"What's Greta Gerwig's filmography?"
"Discover highly-rated sci-fi movies from the 2010s, sorted by rating."
"Where can I stream The Bear in the US?"
"Show me the trailer for Deadpool & Wolverine."
"List the episodes of Severance season 1."
"Which movie has IMDb id tt0111161?"
"Search for people named Zendaya."
"Get the year, genres and rating for these five movies in one go: Dune, Dune: Part Two, Arrival, Sicario and Blade Runner 2049."
"What are the best limited series to binge over a weekend?"
"What TV shows can I watch with my 9-year-old kid?"
"What movies has A24 produced?"
"What are Tarantino's best-rated crime movies?"
"Who composed the music for My Neighbor Totoro, and what else has he scored?"

オプションの（無料の）OMDbキーを設定すると、評価も取得できます。

"What are the IMDb, Rotten Tomatoes and Metacritic scores for The Godfather?"
"Compare the critics' scores for Barbie and Oppenheimer."

インストール

MCPクライアントの設定に追加してください。必須の認証情報はTMDB v4のRead Access Tokenのみです。OMDB_API_KEY（評価）とTMDB_LANGUAGE／TMDB_REGION（ローカライズ）は任意です。

npx経由（インストール不要）：

{
  "mcpServers": {
    "tmdb": {
      "command": "npx",
      "args": ["-y", "tmdb-mcp"],
      "env": {
        "TMDB_API_TOKEN": "your-tmdb-v4-read-access-token (required)",
        "OMDB_API_KEY": "your-omdb-key (optional: IMDb/RT/Metacritic ratings)",
        "TMDB_LANGUAGE": "en-US (optional: localize, e.g. ru-RU)",
        "TMDB_REGION": "US (optional: region for certifications, e.g. RU)"
      }
    }
  }
}

各値を自分のものに置き換えてください。必須なのはTMDB_API_TOKENのみです。不要な場合は、任意と記された行を削除してください。

.mcpbバンドルとして（Claude Desktopに最適）：最新リリースからtmdb-mcp.mcpbをダウンロードし、開くか、Claude Desktopの拡張機能にドラッグしてください。Nodeやnpmが不要な自己完結型バンドルです。インストールダイアログでトークンと任意の項目を入力してください。更新するには、再ダウンロードして再インストールします。

ソースからインストール：git cloneを実行し、続けてnpm ci && npm run buildを実行します。その後、"command": "node"、"args": ["/ABS/PATH/tmdb-mcp/dist/index.js"]、および上記と同じenvを指定して、クライアントから実行します。

クライアントごとの詳細と、すべての設定項目についてはdocs/clients.mdをご覧ください。

できること

ツール	用途
search_movies / search_tv / search_people	タイトルや人物を名前で検索 → TMDB id
search_multi	映画、TV、人物を一括検索します（各行に media_type が含まれます）
get_movie / get_tv	詳細情報 ＋ IMDb／RT／Metacritic の評価（include_ratings で切り替え）
get_movies / get_tv_shows	1回の呼び出しで1〜20個のIDを指定して、コンパクトなカード（タイトル／年／ジャンル／投票平均、評価はオプション）を取得します
get_person	経歴、部門、リンク
get_movie_credits / get_tv_credits	主演キャストと主要スタッフ（TV：全シリーズ分。エピソード数順）
get_movie_recommendations / get_tv_recommendations	共同視聴データに基づくおすすめ（ファンがほかに気に入った作品）
get_similar	アルゴリズムで類似作品を検索（media_type ＋ ID）
get_trending	現在の人気作品（映画／TV／人物、日単位または週単位）
get_movie_releases	TMDB の公開日範囲に基づき、国内で現在上映中（now_playing）または近日公開（upcoming）の映画を取得します
get_movie_genres / get_tv_genres	ジャンル ID ↔ 名前の対応表
discover_movies	ジャンル、期間、評価、キャスト／スタッフ、制作会社、原産国、キーワード、配信サービス（＋／−、視聴形式）、レーティング、地域別公開日で絞り込みます
discover_tv	同様に、ネットワーク／種別／ステータスや期間内に放送されるエピソードでも絞り込めますが、キャスト／スタッフ／人物や地域別公開日のフィルターはありません（人物には get_person_credits を使用）
get_watch_providers	地域別の配信／レンタル／購入先（TMDB 経由の JustWatch）
get_person_credits	人物の出演・スタッフ作品一覧
get_videos	予告編／ティーザー／クリップ（YouTube リンク）
get_reviews	映画／TVのユーザーレビュー（投稿者、評価、本文）
get_collection	映画シリーズ／コレクションと各作品を公開順で取得します
find_by_imdb_id	IMDb ID → TMDB の映画／TV／人物に解決します
get_tv_season / get_tv_episode	シーズンのエピソード一覧／単一エピソードの詳細
search_keywords	discover_* 用にキーワード名を ID に解決します
search_companies	discover_* の with_companies 用に制作会社名を ID に解決します
search_collections	get_collection 用にシリーズ名（例：'harry potter'）をコレクション ID に解決します
search_watch_providers	discover_* の with_watch_providers 用に配信／レンタルサービス名（例：'Netflix'）を ID に解決します
get_ratings	IMDb ID またはタイトルから IMDb／RT／Metacritic の評価を取得します（単独）
プロンプト。 上記のツールに加えて、サーバーは2つのMCPプロンプトを公開します。
recommend_similar（title、任意のmedia_type、任意のcount）は、ユーザーが気に入ったタイトルに似た作品を検索する計画を立て、モデル自身の知識に頼るのではなく、get_similar／get_movie_recommendations／get_tv_recommendations／discover_movies／discover_tvを呼び出します。top_by_entity（name、任意のentity_type、genre、media_type、count）は、人物または制作会社／スタジオの評価が高いタイトル（例：「A24の人気映画」や「タランティーノの最高の犯罪映画」）をdiscover_movies／discover_tvで検索します。また、人物のテレビ作品に限っては、TMDB独自の/discover/tvでは人物による絞り込みが一切できないため、get_person_creditsにフォールバックします。

中核データと追加情報。 主な情報源はTMDB（検索、メタデータ、人物、トレンド）です。OMDbは任意で追加情報を提供します。get_movie／get_tvは、TMDBが返すimdb_idを使ってOMDbを検索するため、評価を1回の呼び出しで取得できます。また、自由記述の受賞概要（主要な賞の受賞・ノミネート。例：映画ならオスカー、番組ならエミー賞。特定の人物ではなく、作品全体に関する情報）と、OMDb独自の年齢制限レーティング（ratings.rated。このサーバー独自のcertificationとは別）も取得できます。OMDbのキーがなくてもTMDBのデータは引き続き利用できますが、ratingsフィールドには未設定であることが示されます。

ローカライズ。 TMDB_LANGUAGE（例：ru-RU）とTMDB_REGION（例：RU）を設定すると、ローカライズされたタイトル、概要、ジャンル名、および地域固有のレーティングを取得できます。search_movies／search_tv／search_multi／search_people／search_collections、get_movie／get_tv／get_movies／get_tv_shows／get_person、get_collection、get_movie_releases、さらにdiscover_movies／discover_tvでは、呼び出しごとにlanguageを指定して上書きすることもできます。

認証情報の取得

必要なトークンは1つ（TMDB）です。OMDbのキーは任意です。どちらも無料です。

1. TMDBトークン（必須）。 themoviedb.orgで無料アカウントを作成し、Settings → APIを開いて、APIキー（個人利用）を申請します。「API Read Access Token」（長いv4トークン。短いv3キーではありません）をコピーし、**TMDB_API_TOKEN**に設定します。これはAuthorization: Bearer …として送信されます。
2. OMDbキー（任意）。 **omdbapi.com/apikey.aspxで無料キーを取得し（無料プランで十分です）、メールに届く有効化リンクをクリックして、OMDB_API_KEY**を設定します。これにより、get_ratingsと、映画およびテレビ番組の詳細に含まれるIMDb／Rotten Tomatoes／Metacriticのスコアが利用できるようになります。キーがなくても、その他の機能はすべて引き続き利用できます。

これらの値は、MCPクライアントの設定にあるenvブロックに追加してください（クライアント別の設定例についてはdocs/clients.mdを参照）。これらをコミットしないでください。 TMDB_LANGUAGE／TMDB_REGIONでは、デフォルトのロケール／地域を任意で設定できます（例：ru-RU、RU）。

高度な調整（環境変数のみ。インストール画面に相当する設定項目はありません）

デフォルト値は適切に設定されています。必要だと分かっている場合にのみ設定してください。環境変数でのみ指定でき、Claude Desktopのインストールフォームには表示されないため、CLI／Dockerのユーザーは直接設定してください。

Variable	Default	Purpose
TMDB_BASE_URL	https://api.themoviedb.org/3	TMDB APIのベースURLを上書きします（プロキシなど）
OMDB_BASE_URL	https://www.omdbapi.com	OMDb APIのベースURLを上書きします
HTTP_TIMEOUT_MS	15000	リクエストを中止するまでのタイムアウト時間
HTTP_RETRIES	2	上流で一時的な障害が発生した場合の再試行回数
TMDB_MIN_INTERVAL_MS	60	TMDBリクエスト間の最小間隔
OMDB_MIN_INTERVAL_MS	0	OMDbリクエスト間の最小間隔
CACHE_TTL_MS	300000	キャッシュされたレスポンスが有効な期間
LOG_LEVEL	info	debug | info | warn | error | silent

TMDB／OMDbが一時的に停止し、ツールが失敗する代わりに期限切れのキャッシュ済みレスポンスを返す場合、通常のデータとともに結果に _meta: {"tmdb-mcp/stale": true} が含まれます。これにより、クライアントは新しい回答と、品質が低下した回答を区別できます。

開発

npm install
npm run build        # type-check + bundle to dist/index.js
npm test             # node:test (mocked, offline)
npm run lint
npm run format
npm run check:api    # live upstream health-check (needs the env credentials)
npm run inspector    # run under the MCP Inspector

実行にはNode ≥ 22.18が必要です。コントリビューター／エージェント向けのガイダンスは AGENTS.mdにあります。

更新

• .mcpbバンドル： リリースページから新しいバンドルをダウンロードして再インストールします。
• ソースから： git pull && npm ci && npm run build。
• npx： バージョンを固定していないnpx -y tmdb-mcpは、次回実行時に最新のものを取得します。

本製品はTMDB APIを使用していますが、TMDBによる推奨または認定を受けていません。

プライバシーポリシー

tmdb-mcpはすべてお使いのマシン上で実行され、独自にデータを収集することはありません。TMDB／OMDbに送信する内容と、ローカルに保存する内容（該当する場合）については、PRIVACY.mdをご覧ください。

セキュリティ

読み取り専用で、接続先の上流ホストは固定の2つです。認証情報は一切保存されません。詳細と脆弱性の報告方法については、SECURITY.mdをご覧ください。

ライセンス

MIT © Grinv