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.