@velxor/mcp

Un servidor MCP (Model Context Protocol) que permite a Claude Code, Cursor y otros agentes compatibles con MCP manejar los tres pilares de Vlexor — edición de video con IA, generación de activos para juegos y producción de gráficos en movimiento — directamente desde una sesión de codificación.

La edición de video se ejecuta en tu propio material: tu video en bruto nunca sale de tu máquina — solo el texto de tus instrucciones (y una transcripción opcional) se envía a Vlexor para generar el plan de edición, que se compila en un comando FFmpeg real y se renderiza completamente de forma local. La generación de activos y los gráficos en movimiento se renderizan del lado del servidor (no hay material local que proteger) y devuelven una URL de descarga firmada — opcionalmente guardada directamente en una ruta local.

Configuración

1. Genera una clave API personal en Vlexor → Configuración → MCP y API.

2. Instala FFmpeg si aún no lo tienes (brew install ffmpeg en macOS, o apunta VLEXOR_FFMPEG_DIR a una carpeta que contenga ffmpeg/ffprobe).

3. Añade esto a la configuración de tu cliente MCP:

{
  "mcpServers": {
    "vlexor": {
      "command": "npx",
      "args": ["-y", "@velxor/mcp"],
      "env": { "VLEXOR_API_KEY": "vlx_…" }
    }
  }
}

Related MCP server: Cognitive Core

Herramientas

Pilar 1 — edición de video (se renderiza localmente; el material nunca se sube):

• probe_media — lee la duración, resolución, fps y códec de un video local.

• generate_edit_plan — instrucción en lenguaje natural → plan de edición estructurado (llama al motor de comandos real de Vlexor; cuenta contra el uso de tu plan).

• compile_edit_plan — plan de edición → comando FFmpeg real, calculado completamente de forma local.

• render — ejecuta el comando compilado localmente para producir el video final.

Un flujo típico del agente: probe_media → generate_edit_plan → (revisar los pasos) → compile_edit_plan → (revisar el comando FFmpeg) → render.

Pilar 2 — generación de activos (se renderiza del lado del servidor):

• generate_game_asset — indicación → textura, personaje 2D, hoja de sprites, modelo 3D (.glb), efecto de sonido, pista musical, fondo de paralaje o giro de personaje. Devuelve una URL de descarga firmada; pasa savePath para también escribir el archivo localmente.

Pilar 3 — gráficos en movimiento (se renderiza del lado del servidor):

• generate_motion_graphic — un breve resumen creativo → un .mp4 de título cinético renderizado (tarjeta de anuncio/promoción). Devuelve una URL de descarga firmada; pasa savePath para también escribir el archivo localmente.

Variables de entorno

Acerca de este repositorio

Este paquete es la capa de integración ligera que conecta un cliente MCP con la API real y alojada de Vlexor — cada llamada de herramienta aquí es una solicitud HTTP simple e inspeccionable (puedes leer exactamente qué sale de tu máquina en src/api-client.ts). Es abierto para que los desarrolladores de agentes que canalizan su clave API a través de él puedan verificarlo por sí mismos.

La plataforma Vlexor en sí — el motor de edición, el diseño de indicaciones de IA, los pipelines de generación de activos/gráficos en movimiento — es de código cerrado. Algunas importaciones de este paquete (el compilador de planes FFmpeg de @velxor/engine, las definiciones de tipos de @velxor/shared) provienen de ese código base privado y no se publican por separado, por lo que este repositorio no se puede pnpm install/compilar de forma independiente — está pensado para leerse y ejecutarse a través del paquete npm precompilado (npx -y @velxor/mcp), no para compilarse desde esta copia.

Se aceptan issues y PRs sobre la capa de integración MCP en sí (esquemas de herramientas, manejo de errores, la orquestación local de FFmpeg).

Licencia

MIT