MCP Video Generation with Veo2

Generación de vídeo MCP con Veo2

Este proyecto implementa un servidor de Protocolo de Contexto de Modelo (MCP) que expone las capacidades de generación de video de Veo2 de Google. Permite a los clientes generar videos a partir de indicaciones de texto o imágenes y acceder a ellos mediante recursos MCP.

Características

• Generar vídeos a partir de indicaciones de texto
• Generar vídeos a partir de imágenes
• Acceda a los vídeos generados a través de los recursos de MCP
• Plantillas de generación de videos de ejemplo
• Compatibilidad con transportes stdio y SSE

Imágenes de ejemplo

Ejemplo de imagen a vídeo

Imagen a video: del cachorro generado por Grok

Imagen a vídeo - de un gato real

Prerrequisitos

• Node.js 18 o superior
• Clave API de Google con acceso a la API de Gemini y al modelo Veo2 (= ¡Necesitas configurar una tarjeta de crédito con tu clave API! -> Ve a aistudio.google.com )

Instalación

Instalación en FLUJO

1. Haga clic en Agregar servidor
2. Copie y pegue la URL de Github en FLUJO
3. Haga clic en Analizar, Clonar, Instalar, Compilar y Guardar.

Instalación mediante herrería

Para instalar mcp-video-generation-veo2 para Claude Desktop automáticamente a través de Smithery :

Instalación manual

1. Clonar el repositorio:
   git clone https://github.com/yourusername/mcp-video-generation-veo2.git cd mcp-video-generation-veo2
2. Instalar dependencias:
   npm install
3. Crea un archivo .env con tu clave API de Google:
   cp .env.example .env # Edit .env and add your Google API key
   El archivo .env admite las siguientes variables:
   • GOOGLE_API_KEY : Su clave API de Google (obligatoria)
   • PORT : Puerto del servidor (predeterminado: 3000)
   • STORAGE_DIR : Directorio para almacenar los vídeos generados (predeterminado: ./generated-videos)
   • LOG_LEVEL : Nivel de registro (predeterminado: fatal)
     • Niveles disponibles: detallado, depuración, información, advertencia, error, fatal, ninguno
     • Para el desarrollo, configúrelo en debug o info para obtener registros más detallados.
     • Para producción, manténgalo como fatal para minimizar la salida de la consola.
4. Construir el proyecto:
   npm run build

Uso

Iniciando el servidor

Puede iniciar el servidor con el transporte stdio o SSE:

Transporte stdio (predeterminado)

Transporte SSE

Esto iniciará el servidor en el puerto 3000 (o el puerto especificado en su archivo .env ).

Herramientas MCP

El servidor expone las siguientes herramientas MCP:

generarVideoDesdeTexto

Genera un vídeo a partir de un mensaje de texto.

Parámetros:

• prompt (cadena): El texto que indica la generación del video
• config (objeto, opcional): Opciones de configuración
  • aspectRatio (cadena, opcional): "16:9" o "9:16"
  • personGeneration (cadena, opcional): "dont_allow" o "allow_adult"
  • numberOfVideos (número, opcional): 1 o 2
  • durationSeconds (número, opcional): Entre 5 y 8
  • enhancePrompt (booleano, opcional): si se debe mejorar el mensaje
  • negativePrompt (cadena, opcional): Texto que describe lo que no se debe generar

Ejemplo:

generarVideoDesdeImagen

Genera un vídeo a partir de una imagen.

Parámetros:

• image (cadena): datos de imagen codificados en Base64
• prompt (cadena, opcional): mensaje de texto para guiar la generación del video
• config (objeto, opcional): Opciones de configuración (igual que la anterior, pero personGeneration solo admite "dont_allow")

lista de vídeos generados

Enumera todos los vídeos generados.

Recursos de MCP

El servidor expone los siguientes recursos MCP:

vídeos://{id}

Acceda a un vídeo generado por su ID.

videos://plantillas

Acceda a plantillas de generación de videos de ejemplo.

Desarrollo

Estructura del proyecto

• src/ : Código fuente
  • index.ts : Punto de entrada principal
  • server.ts : configuración del servidor MCP
  • config.ts : Manejo de configuración
  • tools/ : Implementaciones de herramientas MCP
  • resources/ : Implementaciones de recursos MCP
  • services/ : Integraciones de servicios externos
  • utils/ : Funciones de utilidad

Edificio

Modo de desarrollo

Licencia

Instituto Tecnológico de Massachusetts (MIT)