After Effects MCP

Servidor After Effects MCP

Controle o Adobe After Effects via MCP usando um painel de ponte executado dentro do AE. Este projeto é otimizado para fluxos de trabalho práticos de automação: efeitos, presets, keyframing, marcadores e ferramentas com consciência de áudio.

---

Destaques

• Automação completa de composição e camadas.
• Inspeção profunda de efeitos e edição de propriedades.
• Controles avançados de gráfico de efeitos (temporal + espacial).
• Fluxos de trabalho de pesquisa/lista/aplicação de presets.
• Automação de marcadores e áudio, incluindo pipelines de forma de onda para marcadores.
• Descoberta de catálogo de efeitos instalados (list-available-effects).

Matriz de Recursos

Área	Capacidades
Composição	Criar, inspecionar projeto/composições, obter intervalos de quadros de clipes
Camadas	Criação de texto/forma/sólido/ajuste, atualizações de transformação/propriedades, centralização
Animação	Keyframes de camada, expressões, keyframes de efeito com controles de gráfico
Efeitos	Aplicar por nome/matchName, listar efeitos de camada recursivamente, editar qualquer propriedade de efeito, remover efeitos
Presets	Aplicar .ffx, listar/pesquisar bibliotecas de presets
Marcadores	Adicionar marcador único (comp/camada), adicionar marcadores em lote
Áudio	Definir níveis de canal, inspecionar metadados de áudio, analisar forma de onda WAV, detectar picos

Requisitos

• Adobe After Effects
• Node.js 18+
• npm

No After Effects, habilite:

• Edit -> Preferences -> Scripting & Expressions -> Allow Scripts to Write Files and Access Network

Início Rápido

1. Clone e instale:

git clone https://github.com/TheLlamainator/after-effects-mcp.git
cd after-effects-mcp
npm install

2. Compile:

npm run build

3. Instale o script de ponte:

npm run install-bridge

4. Reinicie o After Effects e abra:

• Window -> mcp-bridge-auto.jsx
• Mantenha este painel aberto durante o uso do MCP.

Configuração do Cliente MCP

Use um caminho absoluto para build/index.js.

{
  "mcpServers": {
    "AfterEffectsMCP": {
      "command": "node",
      "args": ["<absolute-path-to-repo>/build/index.js"]
    }
  }
}

Adicionar ao VS Code

Se você usa uma extensão do VS Code compatível com MCP, adicione este servidor nas configurações de servidor MCP dessa extensão.

Use:

• comando: node
• argumentos: ["<absolute-path-to-repo>/build/index.js"]

Exemplo de trecho que muitas extensões aceitam:

{
  "mcpServers": {
    "AfterEffectsMCP": {
      "command": "node",
      "args": ["C:\\Users\\<you>\\Documents\\Projects\\AEMCP\\build\\index.js"]
    }
  }
}

Então:

1. Reinicie o VS Code.
2. Abra o After Effects e mantenha Window -> mcp-bridge-auto.jsx aberto.
3. Chame uma ferramenta simples como get-help ou run-script com getProjectInfo.

Adicionar ao Claude Desktop

Edite a configuração do Claude Desktop e adicione a entrada do servidor MCP.

Localização típica da configuração no Windows:

• %APPDATA%\\Claude\\claude_desktop_config.json

Exemplo:

{
  "mcpServers": {
    "AfterEffectsMCP": {
      "command": "C:\\Program Files\\nodejs\\node.exe",
      "args": [
        "C:\\Users\\<you>\\Documents\\Projects\\AEMCP\\build\\index.js"
      ]
    }
  }
}

Após salvar:

1. Reinicie completamente o Claude Desktop.
2. Abra o painel de ponte do AE.
3. Verifique com tools/list nos logs ou chamando uma ferramenta conhecida.

Adicionar ao Claude Code

Configure o mesmo comando/argumentos do servidor na sua configuração MCP do Claude Code.

Use esta definição de servidor:

{
  "AfterEffectsMCP": {
    "command": "node",
    "args": ["<absolute-path-to-repo>/build/index.js"]
  }
}

Então:

1. Reinicie o Claude Code ou recarregue os servidores MCP.
2. Garanta que o After Effects esteja aberto com o painel mcp-bridge-auto.jsx em execução.
3. Teste com get-results após um comando enfileirado.

Grafo de Arquitetura

flowchart LR
    A[AI Client<br/>VS Code / Claude Desktop / Claude Code] --> B[MCP Server<br/>build/index.js]
    B --> C[Bridge Files<br/>ae_command.json / ae_mcp_result.json]
    C --> D[After Effects Bridge Panel<br/>mcp-bridge-auto.jsx]
    D --> E[Adobe After Effects]
    E --> D
    D --> C
    C --> B
    B --> A

Grafo de Fluxo de Comandos

sequenceDiagram
    participant Client as MCP Client
    participant Server as MCP Server
    participant Bridge as AE Bridge Panel
    participant AE as After Effects

    Client->>Server: tools/call (example: apply-effect)
    Server->>Server: write ae_command.json
    Server-->>Client: queued response (or waits)
    Bridge->>Bridge: poll command file
    Bridge->>AE: execute command
    AE-->>Bridge: result/error
    Bridge->>Bridge: write ae_mcp_result.json
    Client->>Server: get-results
    Server-->>Client: final result JSON

Fluxo de Execução Típico

1. Inicie seu cliente MCP (ele inicia este servidor).
2. Mantenha o painel de ponte do AE aberto.
3. Chame as ferramentas.
4. Se a resposta disser enfileirado, chame get-results após 1-3 segundos.

Nota: algumas operações do AE terminam um pouco depois das janelas de timeout das ferramentas; get-results geralmente contém o estado final.

Catálogo de Ferramentas

Gerais

• run-script
• get-results
• get-help

Utilitários de Composição e Camadas

• create-composition
• create-adjustment-layer
• center-layers
• get-layer-clip-frames

Efeitos e Presets

• apply-effect
• add-any-effect
• mcp_aftereffects_applyEffect
• apply-effect-template
• list-layer-effects
• list-available-effects
• set-effect-property
• set-effect-keyframe
• remove-effect
• apply-preset
• list-presets
• search-presets

Marcadores e Áudio

• add-marker
• add-markers-bulk
• set-audio-levels
• get-audio-info
• analyze-audio-waveform

Diagnósticos e Auxiliares

• test-animation
• run-bridge-test
• mcp_aftereffects_get_effects_help

Fluxo de Trabalho de Áudio para Marcadores

1. get-audio-info na camada alvo.
2. Copie sourceFilePath.
3. analyze-audio-waveform com numPoints opcional.
4. Converta peakTimes para markers[].
5. add-markers-bulk.

Estrutura do Projeto

• src/index.ts - definições do servidor MCP e ferramentas
• src/scripts/mcp-bridge-auto.jsx - painel de ponte do AE
• install-bridge.js - instalador da ponte

Desenvolvimento

Compile:

npm run build

Instale a ponte:

npm run install-bridge

Execute o servidor diretamente:

node build/index.js

Solução de Problemas

O servidor não inicia

• Execute npm run build.
• Verifique os logs do MCP para exceções de inicialização (por exemplo, registro duplicado de ferramentas).

Comandos enfileiram mas não concluem

• Garanta que o painel de ponte do AE esteja aberto.
• Confirme que a permissão de script/rede do AE está habilitada.
• Tente novamente e chame get-results após um pequeno atraso.

Resultados parecem desatualizados

• Reabra o painel de ponte.
• Envie um novo comando e depois chame get-results.

A instalação em Program Files falha

• Esperado sem permissões elevadas.
• Caminhos de script do AppData do usuário geralmente são suficientes.

Licença

MIT. Veja LICENSE.

Inspiração

https://github.com/Dakkshin/after-effects-mcp

Peguei o código base deles, mas adicionei muita coisa.