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

Por que usar

Principais recursos

14+ tools: comps, layers, cameras, nulls, keyframes, expressions, masks
ExtendScript bridge panel polls for commands — runs in the AE process
Works with Claude Code via .mcp.json; other clients via manual config
Supports blend modes, 3D layers, track mattes, mask feather/expansion
Batch property updates via batchSetLayerProperties

Demo ao vivo

Como fica na prática

after-effects.replay ▶ pronto

0/0

Instalar

Escolha seu 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
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

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

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

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

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

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

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

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

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

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

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

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: after-effects-mcp

Generate template-based lower thirds from a CSV

👤 Motion graphics artists making 10+ lower thirds per episode ⏱ ~20 min intermediate

Quando usar: You have a CSV of names/titles and don't want to type each into a comp.

Pré-requisitos

After Effects 2022+ with the bridge panel installed — npm run install-bridge, then open mcp-bridge-auto.jsx and tick 'Auto-run commands'
MCP added via .mcp.json — Point to build/index.js and restart your client

Fluxo

Create the base comp

Create a composition 'LT_01' 1920x1080 29.97 5s black background.✓ Copiado

→ Comp appears in AE
Add name + title text layers

Add text layer 'Dr. Jane Doe' bottom-left at (120, 900) 72pt. Add text layer 'Lead Scientist' below at (120, 960) 36pt.✓ Copiado

→ Layers visible
Add in/out animation with keyframes

Set position keyframes: both text layers slide in from x=-400 between frames 0-15 and slide out from frames 120-135.✓ Copiado

→ Animated lower third

Resultado: A working lower third template you can duplicate/edit per row in the CSV.

Armadilhas

Bridge panel isn't checked 'Auto-run' — commands queue forever — Open the panel and verify the checkbox every time AE relaunches
Too many commands at once causes AE UI freeze — Batch via batchSetLayerProperties rather than 100 individual calls

Combine com: filesystem

Build an expression-driven data visualization

👤 Motion designers doing infographics ⏱ ~20 min advanced

Quando usar: You want shapes that animate from a data array without keyframing each.

Fluxo

Create base shape

Create a shape layer 'bar_01' — rectangle, center-anchored, 80x0 at (200,900).✓ Copiado

→ Shape at zero height
Attach expression

On bar_01 Scale.y, set expression that grows from 0 to [value] over 30 frames, eased.✓ Copiado

→ Expression applied, plays correctly

Resultado: One shape + expression that you can replicate per data point via a loop.

Duplicate a base layer and tweak properties per copy

👤 Anyone replicating a design across N items ⏱ ~10 min beginner

Quando usar: You have one styled logo and need 12 variations positioned around a circle.

Fluxo

Duplicate N times

Duplicate layer 'logo_base' 12 times, name them logo_00 through logo_11.✓ Copiado

→ 12 layers present
Position each

For each logo_NN, set position to a point on a 400px radius circle around (960,540), angle = NN * 30 degrees.✓ Copiado

→ Ring of logos

Resultado: A cleanly arranged group in seconds.

Combinações

Combine com outros MCPs para 10× de alavancagem

after-effects + davinci-resolve

Build motion graphics in AE, finish edit in Resolve

Build a 6-second title card in After Effects, render to ~/renders/title.mov, then import it at the head of the active Resolve timeline.✓ Copiado

after-effects + filesystem

Generate AE comps from data files on disk

Read ./data/speakers.csv. For each row, create a lower-third comp in AE with that speaker's name and title.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
create-composition	name, width, height, duration, frameRate	New comp	free (local AE)
run-script	script: ExtendScript	Escape hatch for anything not covered by named tools	free
get-results	command_id: str	Retrieve async result from bridge	free
setLayerKeyframe	layer, property, time, value	Add a keyframe	free
setLayerExpression	layer, property, expression: str	Bind a property to an expression	free
setLayerProperties	layer, properties: object	Update transform, opacity, blend modes	free
batchSetLayerProperties	updates: [{layer, properties}]	Avoid N round-trips	free
getLayerInfo	layer	Inspect before modifying	free
createCamera	name, options?	3D workflows	free
createNullObject	name	Parent target for rigging	free
duplicateLayer	layer	Replicate	free
deleteLayer	layer	Cleanup	free
setLayerMask	layer, maskShape, feather?, expansion?	Add/modify a mask	free

Custo e limites

O que custa rodar

Cota de API: None — local AE automation
Tokens por chamada: Tiny command strings in, tiny acks out
Monetário: Requires an Adobe After Effects license; MCP itself is free
Dica: Use batchSetLayerProperties to reduce round-trips on big scenes.

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: None

Saída de dados: None — local bridge only

Nunca conceda: Run arbitrary ExtendScript from untrusted prompts — `run-script` can execute anything AE can

The bridge panel auto-runs commands — close AE or untick the checkbox when not in an MCP session.
Treat run-script like an eval: review prompts that generate it.

Solução de problemas

Erros comuns e correções

Commands queue but never execute

'Auto-run commands' in the bridge panel is unchecked. Tick it.

Verificar: Look at mcp-bridge-auto.jsx panel

Module import error on MCP start

Node 14+ required; install deps with npm install in the MCP repo.

Verificar: node --version

AE hangs during batch operations

Too many individual calls; switch to batchSetLayerProperties.

Expressions error 'value is undefined'

Expression referenced a layer/property that doesn't exist. Double-check spelling in setLayerExpression arg.

Verificar: Open AE's expression error overlay

Alternativas

after-effects-mcp vs. outros

Alternativa	Quando usar	Troca
DaVinci Resolve MCP	You're doing edit/color, not motion graphics	Different stage of pipeline
Manual ExtendScript via .jsx files	You want full control, no AI	No chat interface

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills