after-effects-mcp MCP — Casos de uso, Instalar & Demo en vivo

Por qué usarlo

Características clave

14+ herramientas: composiciones, capas, cámaras, nulos, fotogramas clave, expresiones, máscaras
El panel puente ExtendScript sondea comandos — se ejecuta en el proceso AE
Funciona con Claude Code a través de .mcp.json; otros clientes a través de configuración manual
Soporta modos de fusión, capas 3D, pistas mate, desenfoque/expansión de máscaras
Actualizaciones de propiedades por lotes a través de batchSetLayerProperties

Demo en vivo

Cómo se ve en la práctica

after-effects.replay ▶ listo

0/0

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "after-effects": {
      "command": "npx",
      "args": [
        "-y",
        "after-effects-mcp"
      ],
      "_inferred": true
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "after-effects": {
      "command": "npx",
      "args": [
        "-y",
        "after-effects-mcp"
      ],
      "_inferred": true
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "after-effects": {
      "command": "npx",
      "args": [
        "-y",
        "after-effects-mcp"
      ],
      "_inferred": true
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "after-effects": {
      "command": "npx",
      "args": [
        "-y",
        "after-effects-mcp"
      ],
      "_inferred": true
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "after-effects",
      "command": "npx",
      "args": [
        "-y",
        "after-effects-mcp"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

{
  "context_servers": {
    "after-effects": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "after-effects-mcp"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add after-effects -- npx -y after-effects-mcp

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: after-effects-mcp

Genera tercios inferiores basados en plantilla desde un CSV

👤 Artistas de gráficos en movimiento que crean 10+ tercios inferiores por episodio ⏱ ~20 min intermediate

Cuándo usarlo: Tienes un CSV de nombres/títulos y no quieres escribir cada uno en una composición.

Requisitos previos

After Effects 2022+ con el panel puente instalado — npm run install-bridge, luego abre mcp-bridge-auto.jsx y marca 'Auto-run commands'
MCP añadido a través de .mcp.json — Apunta a build/index.js y reinicia tu cliente

Flujo

Crea la composición base

Crea una composición 'LT_01' 1920x1080 29.97 5s fondo negro.✓ Copiado

→ La composición aparece en AE
Añade capas de texto de nombre + título

Añade una capa de texto 'Dra. Jane Doe' abajo a la izquierda en (120, 900) 72pt. Añade una capa de texto 'Jefa Científica' debajo en (120, 960) 36pt.✓ Copiado

→ Capas visibles
Añade animación de entrada/salida con fotogramas clave

Establece fotogramas clave de posición: ambas capas de texto se deslizan desde x=-400 entre fotogramas 0-15 y se deslizan desde fotogramas 120-135.✓ Copiado

→ Tercio inferior animado

Resultado: Una plantilla de tercio inferior funcional que puedes duplicar/editar por fila en el CSV.

Errores comunes

El panel puente no está marcado 'Auto-run' — los comandos se colan para siempre — Abre el panel y verifica la casilla cada vez que AE se reinicia
Demasiados comandos a la vez causa que la IU de AE se congele — Agrupa a través de batchSetLayerProperties en lugar de 100 llamadas individuales

Combinar con: filesystem

Crea una visualización de datos impulsada por expresiones

👤 Diseñadores de movimiento que crean infografías ⏱ ~20 min advanced

Cuándo usarlo: Quieres formas que se animen desde un array de datos sin keyframing de cada una.

Flujo

Crea la forma base

Crea una capa de forma 'bar_01' — rectángulo, anclado al centro, 80x0 en (200,900).✓ Copiado

→ Forma con altura cero
Adjunta expresión

En bar_01 Scale.y, establece una expresión que crece de 0 a [valor] en 30 fotogramas, suavizada.✓ Copiado

→ Expresión aplicada, se reproduce correctamente

Resultado: Una forma + expresión que puedes replicar por punto de datos a través de un bucle.

Duplica una capa base y ajusta propiedades por copia

👤 Cualquiera que replique un diseño en N elementos ⏱ ~10 min beginner

Cuándo usarlo: Tienes un logo estilizado y necesitas 12 variaciones posicionadas alrededor de un círculo.

Flujo

Duplica N veces

Duplica la capa 'logo_base' 12 veces, nómbralas logo_00 a logo_11.✓ Copiado

→ 12 capas presentes
Posiciona cada una

Para cada logo_NN, establece la posición en un punto de un círculo de radio 400px alrededor de (960,540), ángulo = NN * 30 grados.✓ Copiado

→ Anillo de logos

Resultado: Un grupo bien organizado en segundos.

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

after-effects + davinci-resolve

Construye gráficos en movimiento en AE, termina la edición en Resolve

Construye una tarjeta de título de 6 segundos en After Effects, renderiza a ~/renders/title.mov, luego importa en la cabeza de la línea de tiempo activa de Resolve.✓ Copiado

after-effects + filesystem

Genera composiciones AE desde archivos de datos en disco

Lee ./data/speakers.csv. Para cada fila, crea una composición de tercio inferior en AE con el nombre y título de ese orador.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
create-composition	name, width, height, duration, frameRate	Nueva composición	free (local AE)
run-script	script: ExtendScript	Salida de escape para cualquier cosa no cubierta por herramientas nombradas	free
get-results	command_id: str	Recupera resultado asincrónico del puente	free
setLayerKeyframe	layer, property, time, value	Añade un fotograma clave	free
setLayerExpression	layer, property, expression: str	Vincula una propiedad a una expresión	free
setLayerProperties	layer, properties: object	Actualiza transformación, opacidad, modos de fusión	free
batchSetLayerProperties	updates: [{layer, properties}]	Evita N viajes de ida y vuelta	free
getLayerInfo	layer	Inspecciona antes de modificar	free
createCamera	name, options?	Flujos de trabajo 3D	free
createNullObject	name	Objetivo padre para rigging	free
duplicateLayer	layer	Replica	free
deleteLayer	layer	Limpieza	free
setLayerMask	layer, maskShape, feather?, expansion?	Añade/modifica una máscara	free

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: Ninguno — automatización local AE
Tokens por llamada: Strings de comando diminutos dentro, reconocimientos diminutos afuera
Monetario: Requiere una licencia de Adobe After Effects; el MCP en sí es gratuito
Consejo: Usa batchSetLayerProperties para reducir viajes de ida y vuelta en escenas grandes.

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: Ninguno

Salida de datos: Ninguno — puente local solamente

No conceder nunca: Ejecuta ExtendScript arbitrario desde prompts no confiables — `run-script` puede ejecutar cualquier cosa que AE pueda

El panel puente ejecuta automáticamente comandos — cierra AE o desmarca la casilla cuando no estés en una sesión MCP.
Trata run-script como un eval: revisa los prompts que lo generan.

Resolución de problemas

Errores comunes y soluciones

Los comandos se colan pero nunca se ejecutan

'Auto-run commands' en el panel puente está desmarcado. Márcalo.

Verificar: Mira el panel mcp-bridge-auto.jsx

Error de importación de módulo al iniciar MCP

Se requiere Node 14+; instala dependencias con npm install en el repositorio MCP.

Verificar: node --version

AE se cuelga durante operaciones por lotes

Demasiadas llamadas individuales; cambia a batchSetLayerProperties.

Error de Expresiones 'value is undefined'

La expresión hizo referencia a una capa/propiedad que no existe. Verifica dos veces la ortografía en el argumento setLayerExpression.

Verificar: Abre la superposición de error de expresión de AE

Alternativas

after-effects-mcp vs otros

Alternativa	Cuándo usarla	Contrapartida
DaVinci Resolve MCP	Estás haciendo edición/color, no gráficos en movimiento	Etapa diferente del pipeline
ExtendScript manual a través de archivos .jsx	Quieres control total, sin IA	Sin interfaz de chat

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills