TMDB MCP Server

A Model Context Protocol (MCP) server that provides access to The Movie Database (TMDB) API. This server enables AI assistants to search and retrieve movie information through the MCP interface.

Features

Search movies by title, year, and other criteria
Retrieve detailed movie information
Easy integration with MCP-compatible AI assistants

Prerequisites

Node.js >= 18
TMDB API key (get one from TMDB)

Installation

Clone the repository:

git clone https://github.com/rakeshgangwar/tmdb-mcp-server.git
cd tmdb-mcp-server

Install dependencies:

npm install

Build the server:

npm run build

Configuration

Configure the MCP server in your MCP settings file (typically cline_mcp_settings.json):

{
  "mcpServers": {
    "tmdb": {
      "command": "node",
      "args": ["/path/to/tmdb-mcp-server/dist/index.js"],
      "env": {
        "TMDB_API_KEY": "your-api-key-here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Replace your-api-key-here with your TMDB API key and replace /path/to/ with actual path.

Available Tools

search_movies

Search for movies using The Movie Database API.

Parameters:

query (required): Search query string
year (optional): Filter by release year
page (optional): Page number (default: 1)

Example:

{
  "query": "Inception",
  "year": 2010,
  "page": 1
}

Development

Make your changes in the src directory
Build the project:

npm run build

Test your changes by configuring the MCP server in your settings

Contributing

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -am 'Add some amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

TMDB API for providing the movie database API
Model Context Protocol for the MCP SDK