Power your agent
Perintah milik penerbit sendiri. Bukan endpoint PlugMCP.
Host a copy with our keys and logs.
npx -y @cyanheads/[email protected]Claude Code tidak punya tautan instal untuk perintah lokal. Salin perintah di bawah dan jalankan di terminal.
TMDB_API_KEY=<secret> TMDB_LANGUAGE=<value> TMDB_DEFAULT_REGION=<value> MCP_LOG_LEVEL=<value> claude mcp add io.github.cyanheads-tmdb-mcp-server -- npx -y @cyanheads/tmdb-mcp-server@0.2.0Jalankan di terminal.
{ "mcpServers": { "io.github.cyanheads-tmdb-mcp-server": { "command": "npx", "args": [ "-y", "@cyanheads/[email protected]" ], "env": { "TMDB_API_KEY": "<secret>", "TMDB_LANGUAGE": "<value>", "TMDB_DEFAULT_REGION": "<value>", "MCP_LOG_LEVEL": "<value>" } } }}claude_desktop_config.json
URL remote atau perintah di mesin Anda? Perbedaan kedua cara instal
Jalankan di PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
BukaMovie and TV metadata powered by The Movie Database (TMDB). Search titles and people by name, pull full credits and filmographies, discover titles by filtered criteria, track trending content, and check where to stream in your region.
tmdb_search_titles toolmulti mode (default) mixes movies, shows, and people, tagged with media_type; movie, tv, or person restrict to one typeyear (movie/tv modes), language, include_adult, and page; empty results return normally with recovery guidanceid, media_type, title/name, release_year, overview, vote_average, genre_names, and a poster or profile URLtmdb_get_movie toolappend array (e.g. ["credits"]) to shrink the payloadtmdb_get_watch_providerstmdb_get_show toolappend options as tmdb_get_movie, with content_ratings (US TV rating) in place of release_datesseason_number from seasons[] to tmdb_get_season for episodestmdb_get_season toolseries_id is echoed from the input; season 0 is "Specials"tmdb_get_person toolcombined_credits split into cast_credits and crew_credits, newest first; credits_page (default 1) returns up to 50 of each, with full totals on every pagenext_credits_page for more; pages past the end return empty liststmdb_discover_titles toolwith_genres/without_genres, year or a release_date_gte/lte window, vote_average range, vote_count_gte, with_cast/with_crew (movie), with_networks (tv), with_watch_providers + watch_region, with_original_language, and runtime rangevote_average.desc with vote_count_gte (~100–1000) to keep low-vote titles out of the topwith_watch_providers without watch_region returns region_requiredtmdb_get_trending toolmedia_type: all (default) mixes movies, shows, and people; or restrict to one typetime_window: day or week (default)page for more; empty results return normally with recovery guidancetmdb_get_watch_providers toollinkwatch_region (ISO 3166-1 alpha-2) is required; the response always states the regionwith_watch_providers in tmdb_discover_titlestmdb://movie/{movie_id} resourcetmdb_get_movie — application/jsonmovie_id comes from tmdb_search_titles or tmdb_discover_titlesmovie_not_found error when TMDB returns 404 for the idtmdb://tv/{series_id} resourcetmdb_get_show — application/jsonseries_id comes from tmdb_search_titles or tmdb_discover_titlesshow_not_found error when TMDB returns 404 for the idtmdb://person/{person_id} resourceapplication/json; use tmdb_get_person for further pagesperson_id comes from tmdb_search_titles (mode "person")person_not_found error when TMDB returns 404 for the idBuilt on @cyanheads/mcp-ts-core: stdio and Streamable HTTP transports, pluggable auth (none / jwt / oauth), swappable storage (in-memory, filesystem, Supabase, Cloudflare KV/R2/D1), structured logging with optional OpenTelemetry tracing.
TMDB-specific:
Agent-friendly output:
enrichment.attributionA TMDB API Read Access Token is required. Create a free TMDB account, then copy the API Read Access Token (a v4 JWT) from your API settings — this server authenticates v3 endpoints with Authorization: Bearer <token>, not the legacy ?api_key= query parameter.
Add the following to your MCP client configuration file.
{
"mcpServers": {
"tmdb-mcp-server": {
"type": "stdio",
"command": "bunx",
"args": ["@cyanheads/tmdb-mcp-server@latest"],
"env": {
"MCP_TRANSPORT_TYPE": "stdio",
"MCP_LOG_LEVEL": "info",
"TMDB_API_KEY": "your-tmdb-read-access-token"
}
}
}
}
Or with npx (no Bun required):
{
"mcpServers": {
"tmdb-mcp-server": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@cyanheads/tmdb-mcp-server@latest"],
"env": {
"MCP_TRANSPORT_TYPE": "stdio",
"MCP_LOG_LEVEL": "info",
"TMDB_API_KEY": "your-tmdb-read-access-token"
}
}
}
}
Or with Docker:
{
"mcpServers": {
"tmdb-mcp-server": {
"type": "stdio",
"command": "docker",
"args": [
"run", "-i", "--rm",
"-e", "MCP_TRANSPORT_TYPE=stdio",
"-e", "TMDB_API_KEY=your-tmdb-read-access-token",
"ghcr.io/cyanheads/tmdb-mcp-server:latest"
]
}
}
}
For Streamable HTTP, set the transport and start the server:
MCP_TRANSPORT_TYPE=http MCP_HTTP_PORT=3010 TMDB_API_KEY=... bun run start:http
# Server listens at http://localhost:3010/mcp
git clone https://github.com/cyanheads/tmdb-mcp-server.git
cd tmdb-mcp-server
bun install
cp .env.example .env
# edit .env and set TMDB_API_KEY
All configuration is validated at startup via Zod schemas. Key environment variables:
See .env.example for the full list of optional overrides.
Build and run:
# One-time build
bun run rebuild
# Run the built server
bun run start:stdio
# or
bun run start:http
Run checks and tests:
bun run devcheck # Lint, format, typecheck, security
bun run test # Vitest test suite
bun run lint:mcp # Validate MCP definitions against spec
docker build -t tmdb-mcp-server .
docker run --rm -e TMDB_API_KEY=your-token -p 3010:3010 tmdb-mcp-server
The Dockerfile defaults to HTTP transport, stateless session mode, and logs to /var/log/tmdb-mcp-server. OpenTelemetry peer dependencies are installed by default — build with --build-arg OTEL_ENABLED=false to omit them.
See AGENTS.md (or CLAUDE.md, the same content) for development guidelines and architectural rules. The short version:
try/catch in tool logicctx.log for request-scoped logging, ctx.state for tenant-scoped storagesrc/mcp-server/*/definitions/index.tsThis product uses the TMDB API but is not endorsed or certified by TMDB. Streaming availability data is provided by JustWatch via TMDB and is region-specific.
Issues are welcome. Run checks and tests before submitting:
bun run devcheck
bun run test
Apache-2.0 — see LICENSE for details.
Search, detail, and discovery for movies, TV, and people on The Movie Database (TMDB).
{ "mcpServers": { "io.github.cyanheads-tmdb-mcp-server": { "command": "npx", "args": [ "-y", "@cyanheads/[email protected]" ], "env": { "TMDB_API_KEY": "<secret>", "TMDB_LANGUAGE": "<value>", "TMDB_DEFAULT_REGION": "<value>", "MCP_LOG_LEVEL": "<value>" } } }}Tool
Belum ada daftar tool. Server remote mendapatkannya setelah pemeriksaan kesehatan pertama.
FAQ
Salin konfigurasi stdio untuk Cursor, Claude Desktop, Claude Code, atau VS Code di halaman ini. Konfigurasi ini memakai instalasi dari penerbit, bukan proxy PlugMCP.
Penerbit mencantumkan variabel lingkungan berikut: TMDB_API_KEY, TMDB_LANGUAGE, TMDB_DEFAULT_REGION, MCP_LOG_LEVEL, MCP_HTTP_HOST, MCP_HTTP_PORT, MCP_HTTP_ENDPOINT_PATH, MCP_AUTH_MODE, MCP_TRANSPORT_TYPE.
Tmdb berjalan secara lokal melalui stdio.
Terakhir diperiksa 2026-11-09. Search, detail, and discovery for movies, TV, and people on The Movie Database (TMDB).