TMDB MCP Server

by ShubhanshuSondhiya

319 downloads

Not rated

GitHub

About

Integrates with The Movie Database (TMDB) API, allowing AI assistants to search for movies, retrieve details, and generate related content.

Details

Author: ShubhanshuSondhiya
Downloads: 319
Categories: Developer Tools, Search, Media, Other, API

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name TMDB MCP Server

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "tmdb mcp server": {
            "tmdb-mcp": {
                "command": "node",
                "args": [
                    "/absolute/path/to/your/tmdb-mcp/build/index.js"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "tmdb mcp server": {
            "tmdb-mcp": {
                "command": "node",
                "args": [
                    "/absolute/path/to/your/tmdb-mcp/build/index.js"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "tmdb mcp server": {
            "tmdb-mcp": {
                "command": "node",
                "args": [
                    "/absolute/path/to/your/tmdb-mcp/build/index.js"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "tmdb mcp server": {
            "tmdb-mcp": {
                "command": "node",
                "args": [
                    "/absolute/path/to/your/tmdb-mcp/build/index.js"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "tmdb mcp server": {
            "tmdb-mcp": {
                "command": "node",
                "args": [
                    "/absolute/path/to/your/tmdb-mcp/build/index.js"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "tmdb mcp server": {
            "tmdb-mcp": {
                "command": "node",
                "args": [
                    "/absolute/path/to/your/tmdb-mcp/build/index.js"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "tmdb mcp server": {
            "tmdb-mcp": {
                "command": "node",
                "args": [
                    "/absolute/path/to/your/tmdb-mcp/build/index.js"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "tmdb mcp server": {
            "tmdb-mcp": {
                "command": "node",
                "args": [
                    "/absolute/path/to/your/tmdb-mcp/build/index.js"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "tmdb mcp server": {
            "tmdb-mcp": {
                "command": "node",
                "args": [
                    "/absolute/path/to/your/tmdb-mcp/build/index.js"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "tmdb mcp server": {
            "tmdb-mcp": {
                "command": "node",
                "args": [
                    "/absolute/path/to/your/tmdb-mcp/build/index.js"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "tmdb mcp server": {
            "tmdb-mcp": {
                "command": "node",
                "args": [
                    "/absolute/path/to/your/tmdb-mcp/build/index.js"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "tmdb mcp server": {
            "tmdb-mcp": {
                "command": "node",
                "args": [
                    "/absolute/path/to/your/tmdb-mcp/build/index.js"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "tmdb mcp server": {
            "tmdb-mcp": {
                "command": "node",
                "args": [
                    "/absolute/path/to/your/tmdb-mcp/build/index.js"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "tmdb mcp server": {
            "tmdb-mcp": {
                "command": "node",
                "args": [
                    "/absolute/path/to/your/tmdb-mcp/build/index.js"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "tmdb mcp server": {
            "tmdb-mcp": {
                "command": "node",
                "args": [
                    "/absolute/path/to/your/tmdb-mcp/build/index.js"
                ]
            }
        }
    }
}

From the repository

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.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "tmdb mcp server": {
            "tmdb-mcp": {
                "command": "node",
                "args": [
                    "/absolute/path/to/your/tmdb-mcp/build/index.js"
                ]
            }
        }
    }
}

McpServers

{
    "tmdb-mcp": {
        "command": "node",
        "args": [
            "/absolute/path/to/your/tmdb-mcp/build/index.js"
        ]
    }
}

TMDB MCP Server

This project implements a Model Context Protocol (MCP) server that integrates with The Movie Database (TMDB) API. It enables AI assistants like Claude to interact with movie data, providing capabilities for searching, retrieving details, and generating content related to movies.

Features

Resources

- Static Resources: - tmdb://info - Information about TMDB API - tmdb://trending - Currently trending movies - Resource Templates: - tmdb://movie/{id} - Detailed information about a specific movie

Prompts

- Movie Review: Generate a customized movie review with specified style and rating - Movie Recommendation: Get personalized movie recommendations based on genres and mood

Tools

- Search Movies: Find movies by title or keywords - Get Trending Movies: Retrieve trending movies for day or week - Get Similar Movies: Find movies similar to a specified movie

Setup Instructions

Prerequisites

- Node.js (v16 or later) - npm or yarn - TMDB API key

Installation

1. Clone this repository

   git clone https://github.com/your-username/tmdb-mcp.git

   cd tmdb-mcp

2. Install dependencies

   npm install

3. Configure your TMDB API key
- Create a .env file in the project root (alternative: edit src/config.ts directly)
- Add your TMDB API key: TMDB_API_KEY=your_api_key_here

4. Build the project

   npm run build

5. Start the server

   npm start

Setup for Claude Desktop

1. Open Claude Desktop
2. Go to Settings > Developer tab
3. Click "Edit Config" to open the configuration file
4. Add the following to your configuration:

{
  "mcpServers": {
    "tmdb-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/your/tmdb-mcp/build/index.js"]
    }
  }
}

5. Restart Claude Desktop

Usage Examples

Using Static Resources

- "What is TMDB?"
- "Show me currently trending movies"

Using Resource Templates

- "Get details about movie with ID 550" (Fight Club)
- "Tell me about the movie with ID 155" (The Dark Knight)

Using Prompts

- "Write a detailed review for Inception with a rating of 9/10"
- "Recommend sci-fi movies for a thoughtful mood"

Using Tools

- "Search for movies about space exploration"
- "What are the trending movies today?"
- "Find movies similar to The Matrix"

Development

Project Structure

tmdb-mcp/
├── src/
│   ├── index.ts                # Main server file
│   ├── config.ts               # Configuration and API keys
│   ├── handlers.ts             # Request handlers
│   ├── resources.ts            # Static resources
│   ├── resource-templates.ts   # Dynamic resource templates
│   ├── prompts.ts              # Prompt definitions
│   ├── tools.ts                # Tool implementations
│   └── tmdb-api.ts             # TMDB API wrapper
├── package.json
├── tsconfig.json
└── README.md

Testing

Use the MCP Inspector to test your server during development:

npx @modelcontextprotocol/inspector node build/index.js

License

MIT

Acknowledgements

- The Movie Database (TMDB)
- Model Context Protocol

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

TMDB MCP Server

Features

Resources

Prompts

Tools

Setup Instructions

Prerequisites

Installation

Setup for Claude Desktop

Usage Examples

Using Static Resources

Using Resource Templates

Using Prompts

Using Tools

Development

Project Structure

Testing

License

Acknowledgements

Install

More like this

Sentry

Github

Brave Search

Google Maps

Git

GitLab