ae-mcp

Un servidor MCP avanzado para Adobe After Effects. Proporciona al asistente un kit de herramientas de edición: leer un proyecto, crear y riggear capas, establecer fotogramas clave con curvas de velocidad reales, animar texto, construir formas vectoriales, aplicar efectos y expresiones, controlar los menús nativos — y ver el resultado mediante instantáneas devueltas directamente en la conversación.

Arquitectura

Assistant (MCP)
      │  stdio
┌─────▼──────────────────────────────┐
│  ae-mcp server (Node/TypeScript)   │   easing, SVG, presets, schemas
└─────┬──────────────────────────────┘
      │  1. HTTP 127.0.0.1:9782  (CEP transport, primary)
      │  2. watched JSON files    (ScriptUI transport, fallback)
┌─────▼──────────────────────────────┐
│  bridge inside After Effects       │   CEP panel or ScriptUI panel
└─────┬──────────────────────────────┘
      │  $.evalFile + AEMCP.runFile()
┌─────▼──────────────────────────────┐
│  ExtendScript kernel (AEMCP)       │   ~4,000 lines, 60+ commands
└────────────────────────────────────┘

Tres principios:

• El trabajo pesado permanece en Node. La conversión SVG, las matemáticas de easing, los ajustes preestablecidos de animación — todo preparado en el lado del servidor; el kernel ExtendScript solo ejecuta.

• Los intercambios pasan por archivos. Las solicitudes y respuestas viajan como JSON en disco, evitando los escapes y los límites de tamaño de evalScript. HTTP solo dispara la ejecución.

• Todo es atómico. Cada solicitud — incluso un lote de 50 operaciones — se ejecuta dentro de un único grupo de deshacer: un Ctrl+Z lo deshace todo.

Token de autenticación del bridge

El servidor HTTP del panel CEP escucha en 127.0.0.1 y dispara comandos en After Effects (incluido ae_eval, que ejecuta ExtendScript arbitrario). Para evitar que una página web abierta en el navegador mientras AE se está ejecutando controle el bridge mediante un simple fetch(), el panel genera un token aleatorio en el primer inicio, almacenado en Documents/ae-mcp/bridge/token.txt y republicado en bridge.json (campo token). Cada POST /run o POST /reload debe incluir la cabecera X-AE-MCP-Token; sin ella, el servidor devuelve 401. El cliente MCP (src/bridge/client.ts) lee el token de bridge.json y lo envía automáticamente — no se necesita configuración manual. El token persiste mientras exista token.txt; elimínelo para forzar su regeneración en el siguiente inicio del panel.

El transporte de archivos de reserva (req//res/) no tiene token: se basa en los permisos del sistema operativo sobre la carpeta Documents del usuario, que ya bloquean el acceso desde otra cuenta.

Related MCP server: After Effects MCP Server

Instalación

npm install
npm run build
npm run install-bridge      # installs the CEP extension + ScriptUI panel + kernel

Luego, en After Effects:

• Transporte CEP (recomendado) — reinicie After Effects. El bridge se inicia solo, sin ventana. Ventana > Extensiones > AE MCP Bridge muestra el estado, el puerto y el registro.

• Transporte ScriptUI (sin reinicio) — Archivo > Scripts > Ejecutar archivo de script… y, a continuación, elija Documents/ae-mcp/AE MCP Bridge.jsx. El panel comienza a sondear inmediatamente.

Registre el servidor en su cliente MCP:

claude mcp add ae-mcp -- node "/path/to/ae-mcp/build/index.js"

npm run install-bridge también copia el panel en Scripts/ScriptUI Panels de cualquier instalación de After Effects detectada, lo que permite acoplarlo. Esa copia se encuentra en Program Files y requiere derechos de administrador; si falla, nada más se ve afectado.

Herramientas

Qué lo distingue

Curvas de velocidad reales. ease: "expo.out" no solo aplica Easy Ease — la curva Bézier se convierte en influencia y velocidad por dimensión, calculadas a partir de la velocidad media del segmento, exactamente como al ajustar manualmente el Graph Editor.

Valores relativos. Un slideIn usa mode: "offset": la animación se basa en la posición existente de la capa en lugar de sobrescribirla. La misma idea para la escala con mode: "multiply".

El SVG se convierte en formas reales. ae_shape action=svg convierte path, rect, circle, ellipse, line, polyline, polygon, grupos y sus transformaciones en capas de forma nativas y editables, con rellenos, trazos, discontinuidades y arcos aproximados en Bézier.

Un bucle de retroalimentación visual. ae_render action=snapshot renderiza la composición y devuelve la imagen directamente: el asistente compara su resultado con la referencia y lo corrige, en lugar de trabajar a ciegas.

Lotes atómicos con referencias. Una escena completa se construye en un solo viaje de ida y vuelta, y cada paso puede reutilizar el resultado del anterior mediante {{0.index}} o {{prev.id}}.

Desarrollo

npm run build          # kernel + TypeScript
npm run build:kernel   # kernel only (also checks its syntax)
node scripts/ae.mjs status                       # bridge status
node scripts/ae.mjs layer.list '{"comp":"My Comp"}'
node scripts/selftest.mjs                        # full validation against AE
node scripts/selftest.mjs --keep --only=shape    # subset, keeps the comp

El kernel está dividido en módulos bajo host/kernel/ y se concatena en host/aemcp-kernel.jsx mediante scripts/build-kernel.mjs. Debe seguir siendo compatible con ES3: nada de let/const, nada de Array.prototype.map, nada de JSON nativo (se proporciona un polyfill en el preludio).

Solución de problemas