drakonkat/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_tmdb tool.
- **Get Details**: Fetch detailed information for specific items using the get_tmdb_details tool.
- **Trending Content**: Retrieve trending content across all media types with the trending_all tool.
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
1. Clone the repository and navigate to the project directory.
2. Install dependencies:
3. Set up your TMDB API key as an environment variable:
- On Windows PowerShell:
- On macOS/Linux:
Usage
Starting the MCP Server
To start the server:
The server communicates over stdio and should be configured in your MCP-compatible client (e.g., IDE or chat client) with the command node mcp-tmdb-server.js and the TMDB_AUTH_TOKEN environment variable.
MCP Integration Examples
Here are code snippets showing how to integrate with the MCP tools:
Search for Movies
Get Movie Details
Get Trending Content
MCP Client Integration
Per integrare questo MCP server nel tuo client MCP (come un IDE o un client di chat compatibile), segui questi passi:
1. Installa il pacchetto npm se necessario:
2. Crea o aggiorna il file mcp.json nel tuo client MCP con la seguente configurazione:
Nota: Il TMDB_AUTH_TOKEN può essere impostato a un valore casuale per ora, poiché le chiamate API TMDB sono gratuite e non richiedono autenticazione obbligatoria.
Testing Strategy
The project uses Jest for comprehensive testing, including:
- **Unit Tests**: Validate individual handler functions, input validation, and response formatting (see tests/unit/handlers.test.js).
- **Integration Tests**: Test API interactions with mocked responses, error handling, and network failures (see tests/integration/api.test.js).
- **Protocol Tests**: Ensure MCP protocol compliance, including tool listing and calling (see tests/protocol/mcp.test.js).