Vidu MCP Server

Genera videos a partir de imágenes y gestiona tareas usando la API de generación de video de Vidu.

Documentación

Vidu MCP Server

Servidor de Protocolo de Contexto de Modelo (MCP) para integrarse con la API de generación de video de Vidu. Proporciona herramientas para generar videos a partir de imágenes utilizando los potentes modelos de IA de Vidu.

Características

Conversión de imagen a video: Genera videos a partir de imágenes estáticas con configuraciones personalizables
- Compatibilidad con múltiples modelos: viduq1, vidu1.5, vidu2.0
- Restricciones de duración y resolución específicas por modelo
- Soporte de música de fondo para videos de 4 segundos
- Soporte de URL de devolución de llamada para notificaciones asíncronas
Verificación del estado de generación: Monitorea el progreso de las tareas de generación de video con información de uso de créditos
Carga de imágenes: Carga fácilmente imágenes para usar con la API de Vidu (máximo 10 MB)

Requisitos previos

Node.js (v14 o superior)
Clave de API de Vidu (disponible en el sitio web de Vidu)
TypeScript (para desarrollo)

Instalación

Instalación a través de Smithery

Instalación automática del Servidor de Generación de Video de Vidu para Claude Desktop usando Smithery:

npx -y @smithery/cli install @el-el-san/vidu-mcp-server --client claude

Configuración de Gemini CLI

Para usar con Gemini CLI, agregue la configuración del servidor a ~/.gemini/settings.json:

{
  "mcpServers": {
    "vidu": {
      "command": "node",
      "args": [
        "your_path/vidu-mcp-server/build/index.js"
      ],
      "env": {
        "VIDU_API_KEY": "your_api_key_here"
      }
    }
  }
}

Nota: Reemplace your_path con la ruta real de su directorio de instalación y your_api_key_here con su clave de API de Vidu.

Instalación manual

Clone este repositorio:

git clone https://github.com/el-el-san/vidu-mcp-server.git
cd vidu-mcp-server

Instale las dependencias:

npm install

Cree el archivo .env basado en .env.template y agregue su clave de API de Vidu:

VIDU_API_KEY=your_api_key_here

Uso

Para Gemini CLI

Compile el código TypeScript:

npm run build

Configúrelo en la configuración de Gemini CLI (consulte la sección de Configuración de Gemini CLI arriba)
Reinicie Gemini CLI para cargar el MCP

Herramientas

1. Conversión de imagen a video

Convierte una imagen estática en un video con parámetros personalizables.

Parámetros:

image_url (obligatorio): URL de la imagen a convertir en video
prompt (opcional): Prompt de texto para la generación del video (máximo 1500 caracteres)
duration (opcional): Duración del video de salida en segundos (específico por modelo)
- viduq1: solo 5 segundos
- vidu1.5/vidu2.0: 4 u 8 segundos (predeterminado 4 segundos)
model (opcional): Nombre del modelo de generación ("viduq1", "vidu1.5", "vidu2.0", predeterminado "vidu2.0")
resolution (opcional): Resolución del video de salida (específica por modelo/duración)
- viduq1 (5s): solo 1080p
- vidu1.5/vidu2.0 (4s): "360p", "720p", "1080p" (predeterminado "360p")
- vidu1.5/vidu2.0 (8s): solo "720p"
movement_amplitude (opcional): Amplitud del movimiento de objetos en el cuadro ("auto", "small", "medium", "large", predeterminado "auto")
seed (opcional): Semilla aleatoria para reproducibilidad
bgm (opcional): Agregar música de fondo al video (booleano, predeterminado false, solo videos de 4 segundos)
callback_url (opcional): URL para notificaciones asíncronas cuando cambia el estado de generación

Ejemplo de solicitud:

{
  "image_url": "https://example.com/image.jpg",
  "prompt": "山を背景にした静かな湖",
  "duration": 8,
  "model": "vidu2.0",
  "resolution": "720p",
  "movement_amplitude": "medium",
  "seed": 12345,
  "bgm": false
}

2. Verificación del estado de generación

Verifica el estado de una tarea de generación de video en ejecución.

Parámetros:

task_id (obligatorio): ID de tarea devuelto por la herramienta de conversión de imagen a video

Ejemplo de solicitud:

{
  "task_id": "12345abcde"
}

3. Carga de imágenes

Carga una imagen para usar con la API de Vidu.

Parámetros:

image_path (obligatorio): Ruta local del archivo de imagen
image_type (obligatorio): Tipo de archivo de imagen ("png", "webp", "jpeg", "jpg")

Ejemplo de solicitud:

{
  "image_path": "/path/to/your/image.jpg",
  "image_type": "jpg"
}

Solución de problemas

Problemas con la clave de API: Asegúrese de que la clave de API de Vidu esté configurada correctamente en el archivo .env (para configuración manual) o en la configuración de Gemini CLI (para configuración de Gemini CLI)
Errores de carga de archivos: Asegúrese de que el archivo de imagen sea válido y esté dentro del límite de tamaño (10 MB para la herramienta upload-image, hasta 50 MB para imágenes por URL directa)
Problemas de conexión: Asegúrese de tener acceso a Internet y de poder llegar a los servidores de la API de Vidu
Problemas con Gemini CLI:
- Asegúrese de que el servidor esté compilado (npm run build) antes de configurarlo en Gemini CLI
- Asegúrese de que la ruta en settings.json apunte al archivo build/index.js correcto
- Reinicie Gemini CLI después de los cambios de configuración
- Establezca "disabled": false en la configuración del servidor