Home

Awesome

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

Required Accounts & API Keys

System Requirements

Development Environment

For the best development experience, we recommend:

Features

Tools

Resources

The server provides access to TMDB movie information:

  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:

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.