Servidor MCP de IMDb 🎬

Un potente servidor del Protocolo de Contexto de Modelo (MCP) para buscar, descubrir y reproducir contenido de IMDb. Construido con FastMCP, este servidor proporciona un puente robusto entre los LLM y los metadatos de películas, incluyendo una capa de reproducción personalizada y un panel de control web moderno.

✨ Características

• 🚀 Motor FastMCP: Implementación de MCP de alto rendimiento sobre HTTP transmitible.

• 🔍 Búsqueda inteligente: Lógica de búsqueda parcheada utilizando la API de autocompletado de IMDb para un descubrimiento de títulos fiable y sin autenticación.

• 📺 Capa de reproducción: Integración directa con playimdb.com para enlaces de transmisión instantánea.

• 📊 Panel de control de monitoreo: Interfaz web protegida por contraseña para monitorear métricas, herramientas y estado en tiempo real.

• 🐳 Listo para Docker: Dockerfile multietapa optimizado para una implementación sencilla.

• 🤖 GitHub Actions: Flujo de trabajo de CI/CD automatizado para construir y enviar imágenes a GHCR en etiquetas de lanzamiento.

🛠️ Herramientas incluidas

🚀 Inicio rápido

1. Instalar dependencias

npm install

2. Configurar el entorno

cp .env.example .env

Edita .env para establecer tu WEBUI_PASSWORD.

3. Ejecutar el servidor de desarrollo

npm run dev

🌐 Endpoints

• Endpoint de MCP: http://127.0.0.1:8080/mcp

• Panel de control: http://127.0.0.1:8080/dashboard

• Verificación de estado: http://127.0.0.1:8080/health

🐳 Implementación con Docker

Construye la imagen localmente:

docker build -t imdb-mcp .

Ejecuta el contenedor:

docker run --rm \
  -p 8080:8080 \
  -e HOST=0.0.0.0 \
  -e PORT=8080 \
  -e WEBUI_PASSWORD=your-secure-password \
  -e WEBUI_SESSION_SECRET=your-secret \
  imdb-mcp

Docker Compose

Alternativamente, utiliza Docker Compose para gestionar el contenedor:

docker-compose up -d

Ejemplo de docker-compose.yml:

services:
  imdb-mcp:
    image: ghcr.io/danish-mar/imdb-mcp:latest
    ports:
      - "8080:8080"
    environment:
      - WEBUI_PASSWORD=your-password

📁 Estructura del proyecto

src/
  index.ts       # Entry point & Server initialization
  config.ts      # App configuration & Env loading
  server.ts      # FastMCP instance setup
  tools/         # IMDb tool implementations (Search, Playback, etc.)
  webui/         # Hono routes for the dashboard
  lib/           # Auth & formatting utilities
views/           # EJS templates for the WebUI
.github/         # GitHub Actions workflows for Docker publishing

📝 Notas

• Parche de búsqueda: Este servidor utiliza un respaldo personalizado a la API de autocompletado de IMDb porque los hashes GraphQL estándar de imdb-core están actualmente desactualizados.

• Autenticación: La mayoría de las herramientas no tienen estado y no requieren cookies de IMDb. Para el acceso a listas privadas, puedes extender la sesión de imdbClient en src/tools/index.ts.

• Reproducción: Las URLs de reproducción apuntan a proveedores externos; úsalas de forma responsable.

Construido con ❤️ usando FastMCP y TypeScript.