Vidu MCP Server

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

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 :

Instalación manual

1. Clonar este repositorio:

2. Instalar dependencias:

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

Uso

1. Construya el código TypeScript:

2. Iniciar el servidor:

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:

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:

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:

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.