What is Tmdb Mcp Server

tmdb-mcp-server is a Model Context Protocol (MCP) server that provides access to The Movie Database (TMDB) API, allowing AI assistants to search and retrieve movie information through the MCP interface.

Use cases

Use cases include enabling AI assistants to provide movie recommendations, answering user queries about movies, and integrating movie data into various applications.

How to use

To use tmdb-mcp-server, clone the repository, install the dependencies, build the server, and configure it with your TMDB API key in the MCP settings file.

Key features

Key features include searching for movies by title and year, retrieving detailed movie information, and easy integration with MCP-compatible AI assistants.

Where to use

tmdb-mcp-server can be used in applications that require movie information retrieval, such as AI assistants, chatbots, and entertainment platforms.

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

1. Clone the repository:

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

2. Install dependencies:

npm install

3. 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

1. Make your changes in the src directory
2. Build the project:

npm run build

3. Test your changes by configuring the MCP server in your settings

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -am 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. 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