Vidu MCP

Accede a los modelos de generación de video más recientes de Vidu a través del Protocolo de Contexto de Modelo (MCP).

GitHub
5
Prueba este MCPPatrocinado

Documentación

Vidu MCP

Una herramienta que te permite acceder a los últimos modelos de generación de video de Vidu a través de aplicaciones que admiten el Protocolo de Contexto de Modelo (MCP), como Claude o Cursor.

Documentación en chino

Resumen

Vidu MCP es una herramienta que te permite acceder a los últimos modelos de generación de video de Vidu a través de aplicaciones que admiten el Protocolo de Contexto de Modelo (MCP), como Claude o Cursor. Esta integración te permite generar videos de alta calidad en cualquier momento y lugar, incluyendo texto a video, imagen a video y más.

Características principales

  • Text-to-Video Generation: Genera videos creativos usando indicaciones de texto
  • Image-to-Video Generation: Genera videos creativos usando indicaciones de texto e imagen
  • Reference-to-Video Generation: Genera videos creativos usando indicaciones de texto e imagen
  • StartEnd-to-Video Generation: Genera videos creativos usando indicaciones de texto e imagen

Componentes del sistema

El sistema consta de dos componentes principales:

  1. UVX MCP Server
    • Servidor en la nube basado en Python
    • Se comunica directamente con la API de Vidu
    • Proporciona capacidades completas de generación de video

Instalación y configuración

Requisitos previos

  1. Python 3.10 o superior
  2. UV/UVX
  3. Clave de API de Vidu: Obténla desde la Plataforma Vidu (Esta función requiere Créditos de API, que deben comprarse por separado en Plataforma Vidu

Obtener dependencias

  1. Python:

    • Descárgalo e instálalo desde el sitio web oficial de Python
    • Asegúrate de que Python esté agregado a la ruta de tu sistema

  2. UV/UVX:

    • Instala uv y configura nuestro proyecto y entorno de Python:

Mac/Linux

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Cómo usar el servidor MCP

1. Obtén la clave de API de Vidu

  • Visita la Plataforma Vidu
  • Regístrate o inicia sesión en tu cuenta
  • Crea y copia tu clave de API desde la configuración de la cuenta

2. Descarga las dependencias requeridas

  • Python: Instala Python 3.10 o superior
  • UV/UVX: Instala la última versión estable de UV y UVX

3. Configura el cliente MCP

  • Abre tu cliente MCP (por ejemplo, Claude para Desktop o Cursor)
  • Localiza la configuración del cliente
  • Abre mcp_config.json (o el archivo de configuración correspondiente)
  • Agrega la configuración según el método que uses:
{
  "mcpServers": {
    "Vidu": {
      "command": "uvx",
      "args": [
        "vidu-mcp"
      ],
      "env": {
        "VIDU_API_KEY": "api-key-here", 
        "VIDU_API_HOST": "api-host-here"
      }
    }
  }
}
  • Guarda el archivo de configuración

4. Reinicia el cliente MCP o actualiza el servidor MCP

  • Cierra y vuelve a abrir completamente tu cliente MCP
  • O usa la opción "Actualizar servidor MCP" si está disponible

Configuración específica del cliente

Claude for Desktop

  1. Abre la aplicación de Claude
  2. Navega a Claude > Configuración > Desarrollador > Editar configuración
  3. Abre el archivo claude_desktop_config.json
    • Windows
    • Mac : ~/Library/Application\ Support/Claude/claude_desktop_config.json
  4. Agrega la configuración anterior y guarda
  5. Reinicia Claude
    • Si la conexión es exitosa: la página de inicio no mostrará ningún error y el estado de MCP será verde
    • Si la conexión falla: se mostrará un mensaje de error en la página de inicio

Cursor

  1. Abre la aplicación de Cursor
  2. Ve a Configuración > Protocolo de Contexto de Modelo
  3. Agrega un nuevo servidor
  4. Completa los detalles del servidor como en la configuración JSON anterior
  5. Guarda y reinicia o actualiza el servidor MCP

Ejemplos de uso

Text-to-Video

Usa indicaciones en lenguaje natural a través de Claude o Cursor para generar videos.

Ejemplo básico:

In an ultra-realistic fashion photography style featuring light blue and pale amber tones, an astronaut in a spacesuit walks through the fog. The background consists of enchanting white and golden lights, creating a minimalist still life and an impressive panoramic scene.

Ejemplo avanzado con parámetros:

Generate a night cityscape video with the following parameters:
Prompt: Skyscraper lights twinkling under the night sky, with car lights forming streaks on the road
Model: viduq1
Style: general
Duration: 5 seconds
Aspect Ratio: 16:9
Resolution: 1080p
Movement Amplitude: middle

FAQ

¿Cómo obtengo una clave de API de Vidu?

  • Regístrate en la Plataforma Vidu y genérala en "API-KEY" en tu cuenta.

¿Qué debo hacer si el servidor no responde?

  1. Verifica si tu clave de API es válida
  2. Revisa los registros de errores (normalmente en las carpetas de registros de Claude o Cursor)

¿Cómo obtener créditos?

  • Si aún no has recargado en la plataforma de API, hazlo primero. Plataforma Vidu

¿Dónde puedo encontrar el video generado?

  • Recibirás un enlace URL para ver, descargar o compartir el video.

¿Cuánto tiempo tarda la generación de video?

  • Normalmente de 30 segundos a 5 minutos, dependiendo de la complejidad, la carga del servidor y las condiciones de la red.

¿Qué hacer si encuentras un error spawn uvx ENOENT?

  • Este error suele deberse a rutas de instalación incorrectas de UV/UVX. Puedes resolverlo de la siguiente manera:

Para Mac/Linux:

sudo cp ./uvx /usr/local/bin

Para Windows:

  1. Identifica la ruta de instalación de UV/UVX ejecutando el siguiente comando en la terminal:
where uvx
  1. Abre el Explorador de archivos y localiza los archivos uvx/uv.
  2. Mueve los archivos a uno de los siguientes directorios:
    • C:\Program Files (x86) o C:\Program Files

Soporte

Soporte técnico