The Movie Database (TMDB)

Se integra con la API de The Movie Database (TMDB), permitiendo a los asistentes de IA buscar películas, obtener detalles y generar contenido relacionado.

GitHub
4
Prueba este MCPPatrocinado

Documentación

Servidor MCP de TMDB

Este proyecto implementa un servidor del Model Context Protocol (MCP) que se integra con la API de The Movie Database (TMDB). Permite que asistentes de IA como Claude interactúen con datos de películas, proporcionando capacidades para buscar, recuperar detalles y generar contenido relacionado con películas.

Características

Recursos

  • Recursos estáticos:

    • tmdb://info - Información sobre la API de TMDB
    • tmdb://trending - Películas en tendencia actualmente

  • Plantillas de recursos:

    • tmdb://movie/{id} - Información detallada sobre una película específica

Prompts

  • Reseña de película: Genera una reseña de película personalizada con estilo y calificación especificados
  • Recomendación de película: Obtén recomendaciones de películas personalizadas basadas en géneros y estado de ánimo

Herramientas

  • Buscar películas: Encuentra películas por título o palabras clave
  • Obtener películas en tendencia: Recupera películas en tendencia por día o semana
  • Obtener películas similares: Encuentra películas similares a una película especificada

Instrucciones de configuración

Requisitos previos

  • Node.js (v16 o posterior)
  • npm o yarn
  • Clave de API de TMDB

Instalación

  1. Clona este repositorio

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

  2. Instala las dependencias

    npm install

  3. Configura tu clave de API de TMDB

    • Crea un archivo .env en la raíz del proyecto (alternativa: edita src/config.ts directamente)
    • Añade tu clave de API de TMDB: TMDB_API_KEY=your_api_key_here

  4. Compila el proyecto

    npm run build

  5. Inicia el servidor

    npm start

Configuración para Claude Desktop

  1. Abre Claude Desktop
  2. Ve a Configuración > pestaña Desarrollador
  3. Haz clic en "Editar configuración" para abrir el archivo de configuración
  4. Añade lo siguiente a tu configuración:
{
  "mcpServers": {
    "tmdb-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/your/tmdb-mcp/build/index.js"]
    }
  }
}
  1. Reinicia Claude Desktop

Ejemplos de uso

Uso de recursos estáticos

  • "¿Qué es TMDB?"
  • "Muéstrame las películas en tendencia actualmente"

Uso de plantillas de recursos

  • "Obtén detalles de la película con ID 550" (Fight Club)
  • "Cuéntame sobre la película con ID 155" (The Dark Knight)

Uso de prompts

  • "Escribe una reseña detallada para Inception con una calificación de 9/10"
  • "Recomienda películas de ciencia ficción para un estado de ánimo reflexivo"

Uso de herramientas

  • "Busca películas sobre exploración espacial"
  • "¿Cuáles son las películas en tendencia hoy?"
  • "Encuentra películas similares a The Matrix"

Desarrollo

Estructura del proyecto

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

Pruebas

Usa el MCP Inspector para probar tu servidor durante el desarrollo:

npx @modelcontextprotocol/inspector node build/index.js

Licencia

MIT

Agradecimientos