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:

2. Install dependencies:

3. Build the server:

Configuration

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

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:

Development

1. Make your changes in the src directory

2. Build the project:

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