The Movie Database (TMDB)

Integra com a API do The Movie Database (TMDB), permitindo que assistentes de IA pesquisem filmes, obtenham detalhes e gerem conteúdo relacionado.

GitHub
4
Experimente este MCPPatrocinado

Documentação

Servidor MCP do TMDB

Este projeto implementa um servidor Model Context Protocol (MCP) que se integra à API do The Movie Database (TMDB). Ele permite que assistentes de IA como o Claude interajam com dados de filmes, fornecendo recursos para pesquisar, obter detalhes e gerar conteúdo relacionado a filmes.

Recursos

Recursos Estáticos

  • Recursos Estáticos:

    • tmdb://info - Informações sobre a API do TMDB
    • tmdb://trending - Filmes em alta no momento

  • Modelos de Recursos:

    • tmdb://movie/{id} - Informações detalhadas sobre um filme específico

Prompts

  • Crítica de Filme: Gere uma crítica de filme personalizada com estilo e classificação especificados
  • Recomendação de Filme: Obtenha recomendações personalizadas de filmes com base em gêneros e humor

Ferramentas

  • Pesquisar Filmes: Encontre filmes por título ou palavras-chave
  • Obter Filmes em Alta: Recupere filmes em alta do dia ou da semana
  • Obter Filmes Semelhantes: Encontre filmes semelhantes a um filme especificado

Instruções de Configuração

Pré-requisitos

  • Node.js (v16 ou posterior)
  • npm ou yarn
  • Chave da API do TMDB

Instalação

  1. Clone este repositório

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

  2. Instale as dependências

    npm install

  3. Configure sua chave da API do TMDB

    • Crie um arquivo .env na raiz do projeto (alternativa: edite src/config.ts diretamente)
    • Adicione sua chave da API do TMDB: TMDB_API_KEY=your_api_key_here

  4. Compile o projeto

    npm run build

  5. Inicie o servidor

    npm start

Configuração para o Claude Desktop

  1. Abra o Claude Desktop
  2. Vá para Configurações > aba Desenvolvedor
  3. Clique em "Editar Config" para abrir o arquivo de configuração
  4. Adicione o seguinte à sua configuração:
{
  "mcpServers": {
    "tmdb-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/your/tmdb-mcp/build/index.js"]
    }
  }
}
  1. Reinicie o Claude Desktop

Exemplos de Uso

Usando Recursos Estáticos

  • "O que é o TMDB?"
  • "Mostre-me filmes em alta no momento"

Usando Modelos de Recursos

  • "Obtenha detalhes sobre o filme com ID 550" (Clube da Luta)
  • "Fale-me sobre o filme com ID 155" (Batman: O Cavaleiro das Trevas)

Usando Prompts

  • "Escreva uma crítica detalhada para A Origem com uma classificação de 9/10"
  • "Recomende filmes de ficção científica para um humor reflexivo"

Usando Ferramentas

  • "Pesquise filmes sobre exploração espacial"
  • "Quais são os filmes em alta hoje?"
  • "Encontre filmes semelhantes a Matrix"

Desenvolvimento

Estrutura do Projeto

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

Testes

Use o MCP Inspector para testar seu servidor durante o desenvolvimento:

npx @modelcontextprotocol/inspector node build/index.js

Licença

MIT

Agradecimentos