TMDB MCP Server

Name: TMDB MCP Server
Author: Laksh-star

@Laksh-star

リポジトリ

TMDB MCP Server について

MCP Server with TMDB

基本情報

カテゴリ

その他

ライセンス

MIT

ランタイム

node

トランスポート

stdio

公開者

Laksh-star

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "mcp-server-tmdb": {
      "command": "node",
      "args": [
        "scripts/tool-surface-smoke.mjs",
        "--mcp-url",
        "https://tmdb-mcp.<your-workers-subdomain>.workers.dev/mcp"
      ],
      "env": {
        "TMDB_MCP_ACCESS_TOKEN": "<your-access-token>"
      }
    }
  }
}

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

What is TMDB MCP Server?

The TMDB MCP Server is an MCP (Model Context Protocol) server that wraps The Movie Database (TMDB) API. It provides movie and TV search, streaming availability, cast/crew details, and recommendations for AI assistants such as Codex and Claude Desktop.

How to use TMDB MCP Server?

Obtain a TMDB API key from themoviedb.org, clone the repository, install dependencies with npm install, copy .env.example to .env and add your key, then run npm run install:local to register the server with Codex or Claude Desktop. Verify the integration with a prompt like "What movies are trending this week?".

Key features of TMDB MCP Server

Search movies, TV shows, and people by title or keyword
View trending movies and TV shows (daily/weekly)
Filter movies by genre, year, rating, and language
Get detailed movie and person information
Compare 2–5 movies side-by-side
Find streaming, rental, and purchase availability per country
Workflow tools: weekend watchlist, watch party planning, franchise watch order, collection gap plan, and taste‑based recommendations

Use cases of TMDB MCP Server

Plan a movie night with primary, backup, and wildcard picks including provider availability
Build a completion plan for a franchise with watched/missing entries and remaining runtime
Discover which streaming service a specific title is available on in your region
Get personalized recommendations based on liked and disliked titles
Generate a release‑calendar watchlist with provider‑ready picks and watch‑later scoring

FAQ from TMDB MCP Server

What API key do I need?

A TMDB API key from themoviedb.org (Account Settings → API).

How do I run the server locally?

Clone the repo, run npm install, copy .env.example to .env and set TMDB_API_KEY, then run npm run install:local and restart Codex or Claude Desktop.

Can I run the server remotely?

Yes. Deploy to Cloudflare Workers using npm run worker:deploy after storing TMDB_API_KEY and optionally ACCESS_TOKEN as Worker secrets.

Is authentication required for the remote server?

Authentication is optional. If ACCESS_TOKEN is set, requests to /mcp and /api/concierge require an Authorization: Bearer <token> header. If not set, the Worker is authless for personal testing.