Tmdb MCP Server

🚀 TMDB MCP Server

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

🚀 Quick Start

The TMDB MCP Server allows AI assistants to interact with the TMDB API via the MCP interface. It's a great tool for movie - related information retrieval.

✨ Features

• Search for movies by title, year, and other criteria.
• Retrieve detailed movie information.
• Easily integrate with compatible AI assistants.

📦 Installation

Prerequisites

• Node.js >= 18
• TMDB API key (obtained from TMDB)

Steps

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

📚 Documentation

Configuration

Configure the TMDB server in your MCP settings file (usually 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 /path/to/ with your actual path.

Available Tools

search_movies

Search for movies using the The Movie Database API.

Parameters:

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

Example:

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

Development

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

npm run build

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

Contribution

1. Fork the repository.
2. Create a 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 providing the MCP SDK.