TMDB MCP Server

What is TMDB MCP Server?

TMDB MCP Server is a Model Context Protocol server that integrates with The Movie Database (TMDB) API, enabling AI assistants like Claude to search, retrieve details, and generate content related to movies.

How to use TMDB MCP Server?

Install Node.js v16+, clone the repo, install dependencies, configure a TMDB API key in a .env file, build with npm run build, and start with npm start. For Claude Desktop, add a JSON config entry pointing to the built index.js file.

Key features of TMDB MCP Server

• Static resources for TMDB info and trending movies
• Resource template for detailed movie info by ID
• Prompts for movie reviews and recommendations
• Tools for search, trending, and similar movies
• Uses TMDB API via an included wrapper

Use cases of TMDB MCP Server

• Ask an AI assistant for currently trending movies
• Retrieve detailed info about a specific movie by ID
• Generate a customized movie review with style and rating
• Get personalized movie recommendations by genre and mood
• Search for movies by title or keywords; find similar movies

FAQ from TMDB MCP Server

What is required to run TMDB MCP Server?

Node.js v16 or later, npm or yarn, and a valid TMDB API key.

How do I configure the TMDB API key?

Create a .env file in the project root and add TMDB_API_KEY=your_api_key_here, or edit src/config.ts directly.

What resources and tools are available?

Static resources (tmdb://info, tmdb://trending), a resource template (tmdb://movie/{id}), prompts (Movie Review, Movie Recommendation), and tools (Search Movies, Get Trending Movies, Get Similar Movies).

How do I test the server during development?

Use the MCP Inspector: run npx @modelcontextprotocol/inspector node build/index.js.

Where does the data come from?

All movie data is sourced from The Movie Database (TMDB) via its public API. No local storage of movie data is mentioned.