wizzy-mcp-tmdb
Project Overview and Purpose
The wizzy-mcp-tmdb project is an MCP (Model Context Protocol) server implemented in JavaScript that provides tools to search and retrieve information from The Movie Database (TMDB). It allows AI clients to access movie, TV show, and person data through a standardized protocol.
Key Features
- Search Movies: Perform multi-search across movies, TV shows, and people using the
search_tmdbtool. - Get Details: Fetch detailed information for specific items using the
get_tmdb_detailstool. - Trending Content: Retrieve trending content across all media types with the
trending_alltool.
Installation
Prerequisites
- Node.js version 18 or higher (required for global fetch support)
- A TMDB API key (Bearer token) from your admin, used with the TNL TMDB proxy (production-api.tnl.one)
Setup
Clone the repository and navigate to the project directory.
Install dependencies:
npm installSet up your TMDB API key as an environment variable:
On Windows PowerShell:
$env:TMDB_AUTH_TOKEN="YOUR_TNL_PROXY_BEARER_TOKEN"On macOS/Linux:
export TMDB_AUTH_TOKEN="YOUR_TNL_PROXY_BEARER_TOKEN"






