Wizzy MCP TMDB
drakonkat/wizzy-mcp-tmdb
Acesso integrado ao TMDB via MCP para Claude e clientes compatíveis
Ver no GitHubServidor MCP em JavaScript que integra The Movie Database (TMDB) ao Claude, permitindo buscas e recuperação de dados sobre filmes, séries e pessoas. Funciona como bridge padronizado entre clientes IA e a API do TMDB.
Instalação
npx convez-ai drakonkat/wizzy-mcp-tmdb1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Buscar informações de filmes e séries durante conversas com Claude
- Obter detalhes de conteúdo (elenco, sinopse, ratings) em tempo real
- Descobrir conteúdo em alta (trending) sem sair do cliente MCP
Veredito

MCP server bem estruturado que democratiza o acesso ao TMDB via Protocol padrão. Útil para quem quer enriquecer conversas com Claude com dados de filmes/séries, mas exige chave API válida e configuração manual no cliente.
README
A tradução para o português deste README ainda está na fila.
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 install -
Set 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"
-
Usage
Starting the MCP Server
To start the server:
npm start
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
// Example MCP tool call for searching
{
"method": "tools/call",
"params": {
"name": "search_tmdb",
"arguments": {
"query": "dune",
"page": 1,
"language": "en-US",
"include_adult": false
}
}
}
Get Movie Details
// Example MCP tool call for getting details
{
"method": "tools/call",
"params": {
"name": "get_tmdb_details",
"arguments": {
"type": "movie",
"id": 438631,
"append": "credits,images"
}
}
}
Get Trending Content
// Example MCP tool call for trending content
{
"method": "tools/call",
"params": {
"name": "trending_all",
"arguments": {
"time_window": "day",
"page": 1,
"language": "en-US"
}
}
}
MCP Client Integration
Per integrare questo MCP server nel tuo client MCP (come un IDE o un client di chat compatibile), segui questi passi:
-
Installa il pacchetto npm se necessario:
npm install -g wizzy-mcp-tmdb -
Crea o aggiorna il file
mcp.jsonnel tuo client MCP con la seguente configurazione:{ "mcpServers": { "tmdb": { "command": "npx", "args": ["wizzy-mcp-tmdb"], "env": { "TMDB_AUTH_TOKEN": "YOUR_TNL_PROXY_BEARER_TOKEN" }, "alwaysAllow": [ "get_watch_providers", "discover_tv", "discover_by_provider" ] } } }Nota: Il
TMDB_AUTH_TOKENpuò 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).
Run the test suite with:
npm test
For watch mode:
npm run test:watch
Project Structure
wizzy-mcp-tmdb/
├── mcp-tmdb-server.js # Main MCP server implementation
├── package.json # Project configuration and dependencies
├── MCP_GUIDE.md # Detailed MCP integration guide
├── babel.config.cjs # Babel configuration for Jest
├── tests/
│ ├── unit/
│ │ └── handlers.test.js # Unit tests for handlers
│ ├── integration/
│ │ └── api.test.js # Integration tests for API calls
│ └── protocol/
│ └── mcp.test.js # MCP protocol compliance tests
└── tests/fixtures/ # Mock data for tests
├── movieDetails.json
├── searchMultiResponse.json
└── trendingAllResponse.json
Contributing
We welcome contributions! Please follow these guidelines:
- Fork the repository.
- Create a feature branch.
- Make your changes and add tests.
- Ensure all tests pass.
- Submit a pull request.
License
This project is licensed under the MIT License. See the LICENSE file for details.
Acknowledgments
- Thanks to The Movie Database (TMDB) for providing the API.
- Built using the Model Context Protocol SDK.
Contact
For questions or support, please open an issue on GitHub.