mcp-server-tmdb

npmGitHub
  • Entertainment & Media
JavaScript
MIT
1
  • Apple
  • Linux
A
security – no known vulnerabilities (report Issue)
A
license - permissive license (MIT)
A
quality - confirmed to work

Integrates with The Movie Database (TMDB) API to provide movie information, search capabilities, and recommendations.

  1. Tools
  2. Prompts
  3. Resources
  4. Server Configuration
  5. README.md

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Tools

Functions exposed to the LLM to take actions

NameDescription
search_moviesSearch for movies by title or keywords
get_recommendationsGet movie recommendations based on a movie ID
get_trendingGet trending movies for a time window

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
TMDB_API_KEYYesYour TMDB API key
Need Help?View Source CodeReport Issue
README.md

TMDB MCP Server

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

<a href="https://glama.ai/mcp/servers/g3nl1a0n25"><img width="380" height="200" src="https://glama.ai/mcp/servers/g3nl1a0n25/badge" alt="mcp-server-tmdb MCP server" /></a>

Prerequisites

Before installing and running the TMDB MCP server, ensure you have the following prerequisites installed and configured:

Required Software

  • Node.js
  • npm (Node Package Manager)
    • Version 8.0.0 or higher (comes with Node.js)
    • Verify installation: npm --version
  • TypeScript
    • Will be installed as a project dependency
    • Can be installed globally: npm install -g typescript
    • Verify installation: tsc --version

Required Accounts & API Keys

  • TMDB Account
    • Free account at TMDB
    • API key from TMDB dashboard
    • API access must be approved by TMDB
  • Claude Desktop Application
    • Latest version installed
    • Access to modify configuration files

System Requirements

  • Operating Systems
    • macOS (10.15 or later)
    • Windows 10/11
    • Linux (modern distributions)
  • Hardware Requirements
    • Minimum 4GB RAM
    • 1GB free disk space
    • Stable internet connection

Development Environment

For the best development experience, we recommend:

  • A code editor with TypeScript support (e.g., VS Code)
  • Terminal access
  • Git (for version control)

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

    Getting Started

  1. Get a TMDB API key:
    • Sign up at TMDB
    • Go to your account settings
    • Navigate to the API section
    • Request an API key for developer use
  2. Clone and set up the project:
    git clone [repository-url] cd mcp-server-tmdb npm install
  3. Build the server:
    npm run build
  4. Set up your environment variable:
    export TMDB_API_KEY=your_api_key_here

Usage with Claude Desktop

To integrate this server with Claude Desktop, add the following to your app's server configuration file (located at ~/Library/Application Support/Claude/config.json):

{ "mcpServers": { "tmdb": { "command": "/full/path/to/dist/index.js", "env": { "TMDB_API_KEY": "your_api_key_here" } } } }

Replace /full/path/to with the actual path to your project directory.

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.

Development

To watch for changes during development:

npm run watch

License

This MCP server is licensed under the MIT License. See the LICENSE file for details.

Contributing

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

GitHub Badge

Glama performs regular codebase and documentation scans to:

  • Confirm that the MCP server is working as expected.
  • Confirm that there are no obvious security issues with dependencies of the server.
  • Extract server characteristics such as tools, resources, prompts, and required parameters.

Our directory badge helps users to quickly asses that the MCP server is safe, server capabilities, and instructions for installing the server.

Copy the following code to your README.md file:

Alternative MCP servers

  • mcp-ragdocs

    A
    security
    A
    license
    A
    quality
    An MCP server implementation that provides tools for retrieving and processing documentation through vector search, enabling AI assistants to augment their responses with relevant documentation context
    MIT

  • python-mcp-server

    A
    security
    A
    license
    A
    quality
    Give Claude access to real-time knowledge and premium content. Get rid of Claude's cutoff data and transform Claude's responses with current events, and trusted, premium sources through Linkup's powerful search capability.
    MIT

  • pubmed_search

    A
    security
    A
    license
    A
    quality
    Server to search PubMed (PubMed is a free, online database that allows users to search for biomedical and life sciences literature). I have created on a day MCP came out but was on vacation, I saw someone post similar server in your DB, but figured to post mine.
    MIT
    • Apple

  • nyt

    A
    security
    A
    license
    A
    quality
    This is a TypeScript-based MCP server that allows searching for New York Times articles from the last 30 days based on a keyword.
    MIT
    • Apple