MCP TMDB

🚀 TMDB MCP Server

This project implements a Model Context Protocol (MCP) server integrated with The Movie Database (TMDB) API. It enables AI assistants like Claude to interact with movie data, providing functions for searching, retrieving detailed information, and generating relevant content.

🚀 Quick Start

The TMDB MCP Server allows AI assistants to interact with rich movie data. With it, you can search for movies, get detailed information, and generate customized content.

✨ Features

Resources

• Static Resources:

  • tmdb://info - Information about the TMDB API
  • tmdb://trending - Currently trending movies

• Resource Templates:

  • tmdb://movie/{id} - Detailed information about a specific movie

Prompts

• Movie Reviews: Generate customized movie reviews based on specified styles and ratings
• Movie Recommendations: Get personalized movie recommendations according to genre and mood

Tools

• Search Movies: Find movies by title or keyword
• Get Trending Movies: Retrieve the day's or week's trending movies
• Get Similar Movies: Find movies similar to a specified movie

📦 Installation

Prerequisites

• Node.js (v16 or higher)
• npm or yarn
• TMDB API key

Installation Steps

1. Clone this repository

   git clone https://github.com/your-username/tmdb-mcp.git
   cd tmdb-mcp
   

2. Install dependencies

   npm install
   

3. Configure your TMDB API key

   • Create a .env file in the project root directory (or directly edit src/config.ts)
   • Add your TMDB API key: TMDB_API_KEY=your_api_key_here

4. Build the project

   npm run build
   

5. Start the server

   npm start
   

Configure Claude Desktop

1. Open Claude Desktop
2. Go to Settings > Developer tab
3. Click "Edit Configuration" to open the configuration file
4. Add the following to your configuration:

{
  "mcpServers": {
    "tmdb-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/your/tmdb-mcp/build/index.js"]
    }
  }
}

5. Restart Claude Desktop

💻 Usage Examples

Using Static Resources

• "What is TMDB?"
• "Show currently trending movies"

Using Resource Templates

• "Get information about the movie with ID 550" (Fight Club)
• "Tell me about the movie with ID 155" (The Dark Knight)

Using Prompts

• "Write a detailed review of Inception with a rating of 9/10"
• "Recommend some science fiction movies for a thoughtful mood"

Using Tools

• "Search for movies about space exploration"
• "What are the trending movies today?"
• "Find movies similar to The Matrix"

📚 Documentation

Project Structure

tmdb-mcp/
├── src/
│   ├── index.ts                # Main server file
│   ├── config.ts               # Configuration and API keys
│   ├── handlers.ts             # Request handlers
│   ├── resources.ts            # Static resources
│   ├── resource-templates.ts   # Dynamic resource templates
│   ├── prompts.ts              # Prompt definitions
│   ├── tools.ts                # Tool implementations
│   └── tmdb-api.ts             # TMDB API wrapper
├── package.json
├── tsconfig.json
└── README.md

Testing

Test your server using the MCP inspector during development:

npx @modelcontextprotocol/inspector node build/index.js

📄 License

MIT

Acknowledgments

• The Movie Database (TMDB)
• Model Context Protocol (MCP)