Power your agent
คำสั่งของผู้เผยแพร่เอง ไม่ใช่เอนด์พอยต์ของ PlugMCP
Host a copy with our keys and logs.
npx -y @cyanheads/[email protected]Claude Code ไม่มีลิงก์ติดตั้งสำหรับคำสั่งแบบโลคัล ให้คัดลอกคำสั่งด้านล่างแล้วรันในเทอร์มินัล
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.0รันในเทอร์มินัล
{ "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 แบบรีโมตหรือคำสั่งบนเครื่องของคุณ? การติดตั้งสองแบบต่างกันอย่างไร
รันบน 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.
เปิดMovie 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>" } } }}เครื่องมือ
ยังไม่มีรายการเครื่องมือ เซิร์ฟเวอร์แบบรีโมตจะได้รายการหลังการตรวจสอบสถานะครั้งแรก
FAQ
คัดลอกคอนฟิก stdio สำหรับ Cursor, Claude Desktop, Claude Code หรือ VS Code ได้ในหน้านี้ คอนฟิกนี้ใช้การติดตั้งของผู้เผยแพร่ ไม่ใช่พร็อกซีของ PlugMCP
ผู้เผยแพร่ระบุตัวแปรสภาพแวดล้อมเหล่านี้: 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 ทำงานแบบโลคัลผ่าน stdio
ตรวจสอบล่าสุดเมื่อ 2026-11-09 Search, detail, and discovery for movies, TV, and people on The Movie Database (TMDB).