# TMDB MCP Server

An MCP server that integrates with The Movie Database (TMDB) API to provide movie information, search capabilities, and recommendations.

## Installation

```bash
npx -y @adamayoung/mcp-server-tmdb
```

### Usage with Claude Desktop

Add the following to your Claude Desktop configuration (`~/Library/Application Support/Claude/config.json`):

```json
{
  "mcpServers": {
    "tmdb": {
      "command": "npx",
      "args": ["-y", "@adamayoung/mcp-server-tmdb"],
      "env": {
        "TMDB_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

### Usage with Claude Code

Add the following to your Claude Code settings:

```json
{
  "mcpServers": {
    "tmdb": {
      "command": "npx",
      "args": ["-y", "@adamayoung/mcp-server-tmdb"],
      "env": {
        "TMDB_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

## Prerequisites

- Node.js 18.0.0 or higher
- A [TMDB](https://www.themoviedb.org/) API key

## Features

### Tools

- **search_movies** - Search for movies by title or keywords
- **get_recommendations** - Get movie recommendations based on a movie ID
- **get_trending** - Get trending movies for a specified time window ("day" or "week")

### Resources

- **Movies** (`tmdb:///movie/<movie_id>`) - Comprehensive movie details including title, release date, rating, overview, genres, poster URL, cast, director, and reviews

## Development

```bash
git clone git@github.com:adamayoung/tmdb-mcp.git
cd tmdb-mcp
npm install
npm run build
```

To watch for changes:

```bash
npm run watch
```

## License

This MCP server is licensed under the MIT License. See the LICENSE file for details.