Servidor Vidu MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) para interactuar con la API de generación de video de Vidu. Este servidor 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 vídeo : genere vídeos a partir de imágenes estáticas con configuraciones personalizables

• Verificar el estado de generación : supervisa el progreso de las tareas de generación de video

• Carga de imágenes : cargue imágenes fácilmente para usarlas con la API de Vidu

Related MCP server: Content & Image Generation MCP Server

Prerrequisitos

• Node.js (v14 o superior)

• Una clave API de Vidu (disponible en el sitio web de Vidu )

• TypeScript (para desarrollo)

Instalación

Instalación mediante herrería

Para instalar Vidu Video Generation Server para Claude Desktop automáticamente a través de Smithery :

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

Instalación manual

1. Clonar este repositorio:

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

2. Instalar dependencias:

npm install

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

VIDU_API_KEY=your_api_key_here

Uso

1. Construya el código TypeScript:

npm run build

2. Iniciar el servidor:

npm start

El servidor MCP se iniciará y estará listo para aceptar conexiones de clientes MCP.

Herramientas

1. Imagen a vídeo

Convierte una imagen estática en un vídeo con parámetros personalizables.

Parámetros:

• image_url (obligatorio): URL de la imagen a convertir a vídeo

• prompt (opcional): Aviso de texto para la generación de vídeo (máximo 1500 caracteres)

• duration (opcional): Duración del vídeo de salida en segundos (4 u 8, predeterminado 4)

• model (opcional): Nombre del modelo para la generación ("vidu1.0", "vidu1.5", "vidu2.0", predeterminado "vidu2.0")

• resolution (opcional): Resolución del vídeo de salida ("360p", "720p", "1080p", predeterminado "720p")

• movement_amplitude (opcional): Amplitud de movimiento de los objetos en el marco ("auto", "pequeño", "mediano", "grande", predeterminado "auto")

• seed (opcional): semilla aleatoria para reproducibilidad

Ejemplo de solicitud:

{
  "image_url": "https://example.com/image.jpg",
  "prompt": "A serene lake with mountains in the background",
  "duration": 8,
  "model": "vidu2.0",
  "resolution": "720p",
  "movement_amplitude": "medium",
  "seed": 12345
}

2. Verificar el estado de la generación

Comprueba el estado de una tarea de generación de vídeo en ejecución.

Parámetros:

• task_id (obligatorio): ID de tarea devuelto por la herramienta de imagen a video

Ejemplo de solicitud:

{
  "task_id": "12345abcde"
}

3. Subir imagen

Sube una imagen para usar con la API de Vidu.

Parámetros:

• image_path (obligatorio): Ruta local al 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"
}

Cómo funciona

El servidor utiliza el Protocolo de Contexto de Modelo (MCP) para proporcionar una interfaz estandarizada para herramientas de IA. Al iniciar el servidor, este escucha comandos a través de canales de entrada/salida estándar y responde con resultados en un formato estructurado.

El servidor gestiona toda la complejidad de la interacción con la API de Vidu, incluyendo:

• Autenticación con claves API

• Carga de archivos y validación de formato

• Gestión de tareas asincrónicas y sondeo

• Manejo y reporte de errores

Solución de problemas

• Problemas con la clave API : asegúrese de que su clave API de Vidu esté configurada correctamente en el archivo .env

• Errores de carga de archivos : Verifique que sus archivos de imagen sean válidos y tengan un tamaño inferior a 10 MB

• Problemas de conexión : asegúrese de tener acceso a Internet y poder acceder a los servidores de la API de Vidu

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.