This MCP server integrates with The Movie Database (TMDB) API to provide movie information, search capabilities, and recommendations. 🎬

Features

Tools

• search_movies

  • Search for movies by title or keywords.
  • Input: query (string): Search query.
  • Returns: List of movies with titles, release years, IDs, ratings, and overviews.
  • Example: Search for movies about space exploration.

• get_recommendations

  • Get movie recommendations based on a movie ID.
  • Input: movieId (string): TMDB movie ID.
  • Returns: Top 5 recommended movies with details.
  • Example: Get recommendations based on movie ID 550 (Fight Club).

• get_trending

  • Get trending movies for a specified time window.
  • Input: timeWindow (string): Either "day" or "week".
  • Returns: Top 10 trending movies with details.
  • Example: Get today's trending movies.

Resources

The server provides access to TMDB movie information:

• Movies (tmdb:///movie/<movie_id>)
  • Comprehensive movie details including:
    • Title and release date
    • Rating and overview
    • Genres
    • Poster URL
    • Cast information (top 5 actors)
    • Director
    • Selected reviews
  • All data is returned in JSON format.

Example Usage

Once the server is running with Claude Desktop, you can use commands like:

1. Search for movies:

   "Search for movies about artificial intelligence"

2. Get trending movies:

   "What are the trending movies today?" "Show me this week's trending movies"

3. Get movie recommendations:

   "Get movie recommendations based on movie ID 550"

4. Get movie details:

   "Tell me about the movie with ID 550"

Error Handling

The server includes comprehensive error handling for:

• Invalid API keys
• Network errors
• Invalid movie IDs
• Malformed requests

Error messages will be returned in a user-friendly format through Claude Desktop.