TMDB MCP Server logo

TMDB MCP Server

by Laksh-star

This MCP server integrates with The Movie Database (TMDB) API to provide movie information, search capabilities, and recommendations. It allows users to access movie details, trending movies, and personalized recommendations through a simple interface.

View on GitHub

Last updated: N/A

What is TMDB MCP Server?

The TMDB MCP Server is a tool that connects to The Movie Database (TMDB) API, allowing users to search for movies, get recommendations based on movie IDs, and discover trending movies. It provides a convenient way to access comprehensive movie details, including titles, release dates, ratings, overviews, genres, poster URLs, cast information, and director details.

How to use TMDB MCP Server?

To use the TMDB MCP Server, you need to obtain a TMDB API key, clone the repository, install dependencies, build the server, and set the TMDB_API_KEY environment variable. Then, you can integrate it with Claude Desktop by adding the server configuration to the app's config.json file. Once integrated, you can use natural language commands to search for movies, get recommendations, and retrieve movie details.

Key features of TMDB MCP Server

  • Search for movies by title or keywords

  • Get movie recommendations based on a movie ID

  • Get trending movies for a specified time window

  • Access comprehensive movie details in JSON format

  • Error handling for invalid API keys, network errors, and malformed requests

Use cases of TMDB MCP Server

  • Finding information about specific movies

  • Discovering trending movies to watch

  • Getting personalized movie recommendations

  • Integrating movie data into other applications

  • Building movie-related chatbots or assistants

FAQ from TMDB MCP Server

How do I get a TMDB API key?

Sign up for a free account at TMDB, go to your account settings, navigate to the API section, and request an API key for developer use.

What are the prerequisites for running the server?

You need Node.js (version 18.0.0 or higher), npm (version 8.0.0 or higher), a TMDB account with an approved API key, and Claude Desktop Application installed.

How do I integrate the server with Claude Desktop?

Add the server configuration to your app's server configuration file (located at ~/Library/Application Support/Claude/config.json), specifying the command and environment variables.

What kind of error handling does the server have?

The server includes comprehensive error handling for invalid API keys, network errors, invalid movie IDs, and malformed requests.

How do I contribute to the project?

Contributions are welcome! Please feel free to submit a Pull Request.