CueFrame

CueFrame — MCP, CLI y API de video

CueFrame es un servicio alojado para componer, editar y renderizar video. Conecta tu agente a través de MCP, automatiza una edición desde la CLI, o integra la API REST en tu aplicación. Cada superficie funciona con proyectos editables que contienen clips, subtítulos y gráficos en movimiento, y los renderiza a MP4.

Primer render · Guía de conexión · Plantillas · Referencia de API · Índice de documentación para agentes

Un fotograma de la plantilla Yosemite Peregrines. Mira el video y prueba la misma edición.

Plugin MCP y de agente

Para Claude Code, Codex, Cursor, VS Code y otros agentes locales compatibles, ejecuta esto en tu terminal con Node.js 24 o superior:

npx -y cueframe@0.8 install

El instalador detecta agentes compatibles y añade el endpoint MCP alojado de CueFrame a su configuración. Instala las habilidades en ~/.agents/skills y ~/.claude/skills, preservando por defecto las habilidades modificadas localmente. Puede actualizar múltiples clientes detectados; usa --dry-run para inspeccionar los cambios primero.

Reinicia la sesión de tu agente. Luego pregunta:

Usa la herramienta get_account de CueFrame para verificar mi conexión y mostrar mis créditos disponibles.

Tu cliente puede pedirte que te autentiques o que abras un navegador. Inicia sesión en CueFrame y autoriza la conexión; los clientes OAuth interactivos no necesitan clave de API. Las operaciones en la nube usan créditos. Verifica tu saldo y los costos estimados antes de comenzar trabajo de pago; consulta tarifas de la nube.

ChatGPT y Claude Desktop: usa la configuración de conector alojado de tu cliente con https://api.cueframe.ai/v1/mcp, y luego autentícate. El instalador de terminal no configura ChatGPT. Consulta la guía de conexión y la habilidad de conexión de CueFrame para las rutas compatibles. La instalación de habilidades y la configuración del conector alojado son pasos separados.

¿Ya estás conectado? Omite la instalación y dale a tu agente una tarea de video. Si las herramientas de CueFrame no aparecen, reinicia el cliente y verifica su configuración de conexión MCP.

Crea tu primer video

Prueba el tutorial de primer render de Yosemite: renderiza una plantilla, cambia una palabra y renderiza de nuevo desde el mismo proyecto.

1. Descarga el metraje original completo del Servicio de Parques Nacionales como yosemite-peregrines.mp4. Usa la fuente original, porque la demostración final tiene el título incrustado. Sigue las pautas de descarga y reutilización de la fuente.

2. Dale a tu agente conectado el archivo fuente y esta instrucción:

   Usa CueFrame para iniciar la plantilla yosemite-peregrines desde cueframe-ai/cueframe-templates con este video original. Carga template.cueframe y su matte de sujeto preparado. Previsualiza el proyecto editable y estima los costos de la nube. Después de que apruebe el render, devuelve el enlace MP4 y el ID del proyecto.

3. Después del primer render, pregunta:

   En ese mismo proyecto, reemplaza el título tras el sujeto PHENOMENAL por EXTRAORDINARY. Conserva el metraje, los subtítulos hablados, el audio, la sincronización, la ubicación y la profundidad. Previsualiza el título cambiado, estima el costo del render y renderiza después de que lo apruebe.

La plantilla selecciona 83.616–93.359 segundos del video original. Deberías obtener dos MP4 de un solo proyecto editable. Subir metraje y ejecutar operaciones en la nube usan créditos; los dos renders se facturan por separado.

El proyecto sigue siendo editable: el editor de escritorio muestra el título como una capa separada, junto con el metraje y los subtítulos. Mira el cambio de título.

¿Qué sucede a través de MCP?

flowchart LR
    A[Your request + footage] --> B[Your agent + CueFrame skills]
    B --> C[Hosted CueFrame MCP]
    C --> D[Editable project + preview]
    D --> E[Render job → MP4 link]

El agente inspecciona las herramientas disponibles, verifica tu cuenta, prepara el medio y el proyecto, previsualiza los cambios y envía un render. Las operaciones de larga duración devuelven IDs; el agente espera a que se completen y te da el resultado. No necesitas escribir las llamadas de herramienta tú mismo. La guía de inicio rápido detallada explica las llamadas individuales.

Para tu próximo video, describe el resultado y proporciona las entradas:

Convierte esta entrevista en un clip vertical de 20 segundos con subtítulos sincronizados con las palabras. Previsualiza el momento más fuerte y muestra los costos estimados antes de renderizar.

Encuentra un componente de carrusel de imágenes para estas fotos de producto. Muestra opciones adecuadas y sus entradas requeridas antes de crear el video.

Cambia solo el título final en este proyecto. Mantén el resto de la edición sin cambios.

Otras opciones de instalación

Elige una ruta de configuración. Un plugin instala las habilidades y la configuración MCP alojada juntas. Una conexión solo de servidor añade herramientas; las habilidades proporcionan la guía del flujo de trabajo.

claude plugin marketplace add cueframe-ai/cueframe-mcp
claude plugin install cueframe@cueframe

codex plugin marketplace add cueframe-ai/cueframe-mcp
codex plugin add cueframe@cueframe

gemini extensions install https://github.com/cueframe-ai/cueframe-mcp

npx skills add cueframe-ai/cueframe-mcp

claude mcp add --transport http cueframe https://api.cueframe.ai/v1/mcp

Habilidades incluidas

Las habilidades enseñan al agente cómo llevar a cabo tareas de video. Tú describes la tarea; el agente selecciona la guía relevante.

El hook de sesión de Claude Code y la regla de Cursor ayudan a seleccionar el punto de entrada. Otros hosts cargan las habilidades instaladas a través de sus propios mecanismos. Las ediciones limitadas deben preservar el trabajo no relacionado.

CLI

Usa la CLI para comandos de video explícitos, scripts de shell y salida JSON estructurada. Se conecta a la API alojada; no ejecuta un renderizador local. Requiere Node.js 24 o superior.

npx -y cueframe@0.8 --help
npx -y cueframe@0.8 login
npx -y cueframe@0.8 api GET /v1/me --json
npx -y cueframe@0.8 describe --json

login abre el navegador para autenticarse. Los scripts sin interfaz pueden proporcionar CUEFRAME_API_KEY. La solicitud de cuenta verifica tu conexión y créditos; describe lista los argumentos y opciones de comandos sin hacer una llamada a la API.

Guía de CLI · Tutorial de CLI · Plantillas · Paquete npm

API y SDK de TypeScript

Usa la API REST para crear proyectos, importar medios, cambiar composiciones y seguir trabajos de render desde tu aplicación. Las solicitudes van a https://api.cueframe.ai con una clave de API desde tu cuenta. Verifica tu cuenta antes de operaciones medidas; el renderizado y procesamiento en la nube usan créditos.

Para TypeScript o JavaScript en Node.js 24+, instala el cliente tipado:

npm install @cueframe/sdk

import { account, createClient } from "@cueframe/sdk";

if (!process.env.CUEFRAME_API_KEY) throw new Error("Set CUEFRAME_API_KEY");
createClient({
  baseUrl: "https://api.cueframe.ai",
  apiKey: process.env.CUEFRAME_API_KEY,
});
const result = await account.getAccount();
console.log(result.plan, result.entitlements);

Otros lenguajes pueden llamar a REST directamente o generar un cliente desde el contrato OpenAPI público versionado. El SDK es un cliente para el servicio alojado, no la implementación del servidor.

Tutorial de API · Referencia de API · Guía de SDK · Ejemplo de render · Paquete npm

Qué contiene este repositorio

Este repositorio contiene el plugin de agente, el kit de herramientas para desarrolladores y los archivos de registro. El servidor MCP alojado se mantiene por separado en el repositorio de la aplicación. Te conectas al servicio alojado de CueFrame; clonar este repositorio no ejecuta ese servicio localmente.

Contribuye

Documentación, ejemplos de clientes, mejoras de habilidades y correcciones del kit de herramientas son bienvenidos. Comienza con primeros problemas buenos o lee CONTRIBUTING.md para la configuración, reglas de archivos generados, pruebas y firma de confirmaciones.

Edita habilidades en la raíz skills/; cambia los clientes de API generados a través de sus entradas documentadas. Reporta problemas del servicio alojado en el rastreador de problemas de este repositorio con pasos de reproducción y un ID de solicitud cuando esté disponible. Reporta vulnerabilidades de forma privada usando SECURITY.md. La participación comunitaria sigue el Código de Conducta.

Paquetes publicados

Paquete	Propósito	npm
@cueframe/api-contract	El documento OpenAPI público, su inventario de operaciones revisado y un manifiesto con direccionamiento por contenido: la única entrada que leen los clientes generados.
@cueframe/sdk	Cliente TypeScript tipado basado en fetch con esquemas de solicitud zod y ayudantes SSE para el progreso de render y composición.
cueframe	La CLI: inicio de sesión, proyectos, medios, composiciones, renders, exportaciones y install, cada comando con --json.
@cueframe/skills	El árbol skills/ como paquete npm (SKILLS_DIR de @cueframe/skills/dir), para programas que copian o incrustan las habilidades.
El servidor MCP en sí (@cueframe/mcp) es un paquete privado mantenido en el repositorio de la aplicación; este repositorio incluye el contrato del que se genera, los clientes, el plugin, la entrada del registro (server.json) y un shim de descubrimiento, no el servidor.

Cómo fluye el contrato

private API ──sync──▶ api/openapi.json (+ scene-schema.json, scene-examples.json, contract-manifest.json)
                          │
                          ├──▶ packages/api-contract/dist  ──publish──▶  @cueframe/api-contract@x.y.z ──▶ the MCP server's generators, third parties
                          └──▶ packages/sdk/src/generated        (Orval: operations, models, zod)

La API privada publica su proyección OpenAPI en api/; pnpm generate:api-consumers incorpora el esquema de escena al contrato y regenera el SDK a partir de él. Esta es la única copia del contrato: los generadores del servidor MCP en el repositorio de la aplicación y todos los demás consumidores lo leen del paquete npm @cueframe/api-contract, cuya versión se mueve con el contrato (pnpm check:contract-version falla ante un cambio de api/*.json sin un bump), por lo que la superficie de herramientas y el SDK siempre describen un único contrato. Nada bajo api/ o un directorio generated/ se edita a mano: pnpm check:api-inputs demuestra que las tres entradas de api/*.json provienen de una sola sincronización, y pnpm check:api-consumer-drift demuestra que los árboles generados coinciden byte a byte con ellas.

Cómo fluyen las habilidades

La raíz skills/ es la única fuente: los hosts del plugin la leen desde este repositorio, y pnpm build la copia en packages/skills/dist (publicado como @cueframe/skills) y desde allí al dist/skills de la CLI para cueframe install. pnpm check:plugin valida cada habilidad y manifiesto; agents/openai.yaml y assets/icon.svg junto a cada habilidad se generan.

Archivos del registro

• server.json: la entrada del registro MCP para el servidor alojado (ai.cueframe/cueframe, solo remotos). pnpm check:server-json lo valida contra el esquema de registro incluido; el trabajo registry del flujo de publicación lo publica.
• glama.json: el archivo de mantenimiento del listado de Glama.
• glama/ y el Dockerfile: un shim de descubrimiento stdio que reproduce una instantánea de la lista de herramientas e instrucciones del servidor alojado para registros que inspeccionan a través de stdio. No es un servidor (ver más abajo).

Alojado, local de escritorio y el shim de descubrimiento

El servicio alojado, la integración de escritorio y el shim de registro cumplen propósitos diferentes.

• El servidor alojado en https://api.cueframe.ai/v1/mcp es el producto. Cada línea de instalación anterior se comunica con él; se autentica con OAuth o una clave API y realiza la composición y el renderizado. Su paquete, @cueframe/mcp, es privado.
• La aplicación de escritorio CueFrame incluye su propio servidor MCP local para el proyecto que tengas abierto. No requiere cuenta y se conecta a través del archivo de conexión que publica la aplicación; la configuración de Agents de la aplicación muestra el comando exacto, y https://docs.cueframe.ai lo explica. Su binario incluido se llama cueframe-mcp; vive dentro del paquete de la aplicación.
• El shim de descubrimiento de este repositorio (glama/server.mjs, construido por el Dockerfile) no es un servidor. Reproduce una instantánea de la lista de herramientas e instrucciones del servidor alojado a través de stdio para que los registros que construyen una imagen puedan listar las herramientas sin una cuenta; cada tools/call responde con un puntero al servidor alojado. glama/refresh-snapshot.md indica de dónde proviene la instantánea.

Estructura del repositorio

• skills/<name>/SKILL.md: la habilidad. agents/openai.yaml y assets/icon.svg junto a ella se generan (pnpm build:plugin).
• .claude-plugin/, hooks/, .mcp.json: plugin de Claude Code, enrutador de sesiones y servidor.
• .codex-plugin/, .agents/plugins/, mcp.json: plugin y marketplace de Codex y ChatGPT.
• .cursor-plugin/, rules/: plugin de Cursor y la regla siempre activa.
• gemini-extension.json, skills.sh.json, plugin.json: CLI de Gemini, skills.sh, el manifiesto portátil (agent-plugins.org).
• api/, packages/, tools/, scripts/: el contrato, los cuatro paquetes npm, sus generadores y comprobaciones (scripts/plugin/ contiene los del plugin).
• server.json, glama.json, glama/, Dockerfile: los archivos del registro.
• examples/, llms-install.md: configuración por cliente y la guía de instalación legible por agentes.

Desarrollo

pnpm install
pnpm check      # input provenance, the contract version rule, the public-contract gate, server.json, the plugin, and tsc --noEmit in sdk and cli
pnpm build      # stamps the plugin manifests and skill cards, then tsup in every package; the CLI packages the skills
pnpm test

Node 24 o más reciente y pnpm (ver .nvmrc y packageManager). CONTRIBUTING.md explica qué rutas se generan, el contrato de habilidades y cómo viaja un cambio; AGENTS.md es lo mismo para un agente que trabaja en este árbol; llms-install.md conecta un cliente paso a paso.

Licencia

Apache-2.0. Ver LICENSE y NOTICE.