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

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