Skip to main content
Glama
enesjakozh

TMDB MCP Server

by ShubhanshuSondhiya
GitHub
TypeScript
1
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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"] } } }
  1. 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

Install Server
A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

Enables AI assistants like Claude to interact with The Movie Database (TMDB) API, providing capabilities for searching movies, retrieving movie details, and generating customized movie reviews and recommendations.

  1. Features
    1. Resources
    2. Prompts
    3. Tools
  2. Setup Instructions
    1. Prerequisites
    2. Installation
    3. Setup for Claude Desktop
  3. Usage Examples
    1. Using Static Resources
    2. Using Resource Templates
    3. Using Prompts
    4. Using Tools
  4. Development
    1. Project Structure
    2. Testing
  5. License
    1. Acknowledgements

      Related MCP Servers

      • mcp-server-tmdb

        Laksh-star
        -
        security
        A
        license
        -
        quality
        Integrates with The Movie Database (TMDB) API to provide movie information, search capabilities, and recommendations.
        Last updated -
        3
        48
        JavaScript
        MIT License
        • Apple
        • Linux

      • dbt Semantic Layer MCP Server

        TommyBez
        -
        security
        A
        license
        -
        quality
        A server that enables querying the dbt Semantic Layer through natural language conversations with Claude Desktop and other AI assistants, allowing users to discover metrics, create queries, analyze data, and visualize results.
        Last updated -
        10
        TypeScript
        MIT License

      • TMDB MCP Server

        rakeshgangwar
        -
        security
        A
        license
        -
        quality
        Enables AI assistants to search and retrieve movie information from The Movie Database (TMDB) API through the Model Context Protocol interface.
        Last updated -
        2
        JavaScript
        MIT License

      • Movie MCP Server

        yusaaztrk
        -
        security
        F
        license
        -
        quality
        A Model Context Protocol server that enables searching and retrieving detailed information about movies and TV shows using The Movie Database (TMDB) API.
        Last updated -
        Python

      View all related MCP servers

      New MCP Servers

      MCP directory API

      We provide all the information about MCP servers via our MCP API.

      curl -X GET 'https://glama.ai/api/mcp/v1/servers/ShubhanshuSondhiya/MCP-TMDB'

      If you have feedback or need assistance with the MCP directory API, please join our Discord server