🎬 VE-MCP: Editor de video autónomo con IA

Servidor del Protocolo de Contexto de Modelo (MCP) para montaje automatizado de video de formato corto, Reels, TikTok, demostraciones de productos SaaS y localización.

English • Русская документация • Навигатор агента • Манифест

⚡ Descripción general

VE-MCP equipa a los agentes de IA (Claude Desktop, Cursor, Antigravity, AutoGPT) con superpoderes profesionales de edición de video. Transforma grabaciones de pantalla en bruto, videos de persona hablando o guiones en bruto en videos verticales 9:16 listos para publicar en una única pasada de renderizado de alto rendimiento.

flowchart LR
    A["Raw Footage / Prompt"] --> B["AI Agent + VE-MCP"]
    
    subgraph VE_MCP ["VE-MCP Single-Pass Engine"]
        B --> C["Silence Cutter (auto-editor)"]
        C --> D["Speech-to-Text & Karaoke ASS (faster-whisper)"]
        D --> E["Voicebox / Edge-TTS Voiceover"]
        E --> F["Single-Pass FFmpeg (9:16 + Zooms + EBU R128 Ducking + Subtitles)"]
    end
    
    F --> G["Ready-to-Publish 9:16 MP4 🎉"]

Related MCP server: ViralSpin MCP

🚀 Características principales

• ✂️ Eliminación inteligente de silencios (cut_silence): Elimina dudas, tartamudeos y pausas de las grabaciones en bruto usando auto-editor.

• 🗣️ Síntesis de voz con Voicebox y Edge-TTS (synthesize_speech): Integración nativa con Voicebox local (puerto 17493) con respaldo fluido a Microsoft Edge Neural TTS (multilingüe, sin necesidad de claves API).

• ✨ Subtítulos karaoke conscientes de pausas (generate_karaoke_subtitles): Subtítulos resaltados a nivel de palabra (.ass) renderizados con tipografía Montserrat e Inter. Divide líneas automáticamente en las pausas del habla (>0.35s) para eliminar el texto pegado en pantalla.

• 🎨 Etalonaje profesional de color y luz (adjust_video_color_and_light): Exposición, contraste, saturación, gamma, nitidez y temperatura de color ajustables por IA con ajustes preestablecidos integrados (vibrant, clean_screencast, cinematic, warm, cold, high_contrast).

• 📐 Conversor de relación de aspecto multiformato (format_video): Conversión en una sola pasada a 9:16 (Reels/Shorts), 16:9 (YouTube horizontal), 1:1 (publicación cuadrada), 4:5 (Feed) con fondos desenfocados, recorte inteligente o letterboxing.

• 📱 Formato vertical 9:16 (format_vertical_video): Desenfoque de fondo de alta calidad (blur_background), recorte centrado o formato con relleno.

• 👥 Diseño de demostración SaaS en pantalla dividida (format_split_screen_demo): Diseño vertical de dos niveles: orador arriba, screencast de la aplicación abajo con mezcla de audio de doble canal.

• 🔍 Jump-zooms dinámicos (apply_jump_zooms): Zooms de acercamiento periódicos automatizados para aumentar la retención de la audiencia.

• 🔊 Normalización de audio de difusión y ducking (add_audio_and_ducking): Audio nivelado según EBU R128 (loudnorm) con compresión sidechain (la música de fondo baja automáticamente cuando hay voz activa).

• 🎨 Superposiciones y efectos de sonido (add_visual_overlay_and_sfx): Insignias flotantes, logotipos y llamadas de interfaz con disparadores de efectos de sonido incluidos (pop.wav, whoosh.wav, click.wav).

• 🛡️ Validador de control de calidad automatizado (validate_video_quality): Verificación integrada con ffprobe de la resolución 9:16/16:9, estado del flujo de audio e integridad del contenedor.

• ⚡ Pipelines compuestos con un clic: create_reels_from_raw_video y create_promo_from_script con etalonaje de color integrado.

🛠️ Referencia de herramientas MCP

📦 Inicio rápido con Docker

1. Construir la imagen de Docker

docker build -t video-editor-mcp:latest .

2. Exportar / Compartir con un amigo

# Save to tar archive:
docker save video-editor-mcp:latest -o video-editor-mcp.tar

# On friend's machine:
docker load -i video-editor-mcp.tar

⚙️ Conexión con asistentes de IA

Claude Desktop / Cursor / Antigravity

Añade lo siguiente a tu archivo de configuración MCP (por ejemplo, claude_desktop_config.json):

{
  "mcpServers": {
    "video-editor": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "C:/Projects/my-videos:/data",
        "--add-host=host.docker.internal:host-gateway",
        "video-editor-mcp:latest"
      ]
    }
  }
}

(Reemplaza C:/Projects/my-videos con la ruta a tu espacio de trabajo de video en el host).

Ejecución nativa con Python (sin Docker)

pip install -r requirements.txt
python server.py

🤖 Cómo reciben instrucciones automáticamente los agentes de IA

Al conectar el servidor, el asistente de IA recibe todos los reglamentos e instrucciones automáticamente a través de 3 mecanismos integrados:

1. 🚀 Prompt nativo del Protocolo MCP (instrucciones FastMCP):

   • En el momento de la conexión del cliente, el servidor server.py transmite automáticamente el prompt del sistema (SERVER_INSTRUCTIONS) en la respuesta de initialize. Cualquier cliente moderno (Claude Desktop, Cursor, Antigravity, Cline) comprende inmediatamente el árbol de decisiones, los ajustes preestablecidos de color y los formatos sin configuración manual.

2. 📖 Recursos MCP (docs://index, docs://playbook):

   • El servidor proporciona recursos interactivos con la base de conocimientos completa, que el agente puede leer a través del protocolo MCP en cualquier momento.

3. 📂 Instrucciones del repositorio (AGENTS.md, CLAUDE.md, SKILL.md):

   • En la raíz del repositorio se han creado los archivos AGENTS.md, CLAUDE.md y .agents/skills/video-editor/SKILL.md. Los entornos de desarrollo (Cursor, Antigravity, Claude Code) los leen automáticamente al abrir el proyecto.

📚 Documentación y guías de escenarios

• 🧭 Índice maestro del agente y árbol de decisiones — Navegación rápida para agentes de IA.

• 🤖 Manual operativo del agente — Ciclo de vida paso a paso desde el prompt hasta el control de calidad.

• 📋 Marco de briefing y redacción de guiones — Entrevista de usuario de 5 preguntas y fórmula H-V-C.

• 💻 Demostraciones SaaS y screencast — Demostraciones de funciones de producto y promociones de changelog.

• 📱 Reels, TikTok y momentos destacados de podcasts — Edición de persona hablando y corte de clips virales.

• 🎓 Tutoriales educativos y de procedimientos operativos estándar — Conversión de guías de texto en videos.

• 🌍 Localización y doblaje — Traducción con Voicebox y redimensionado de archivos.

• 🤝 Prospección comercial y soporte — Tutoriales personalizados de soporte al cliente.

• ⏰ Automatización Cron y CI/CD — Resúmenes de noticias diarios automatizados y vistas previas de PR.

📄 Licencia

Este proyecto está licenciado bajo la Licencia MIT.