Adobe After Effects

Controle o Adobe After Effects por meio de um protocolo padronizado, permitindo assistentes de IA e outras aplicações.

Documentação

🎬 After Effects MCP Server

License

✨ Um servidor Model Context Protocol (MCP) para Adobe After Effects que permite que assistentes de IA e outros aplicativos controlem o After Effects por meio de um protocolo padronizado.

📦 Recursos

🎥 Recursos Principais de Composição

Criar composições com configurações personalizadas (tamanho, taxa de quadros, duração, cor de fundo)
Listar todas as composições de um projeto
Obter informações do projeto como taxa de quadros, dimensões e duração

🧱 Gerenciamento de Camadas

Criar camadas de texto com propriedades personalizáveis (fonte, tamanho, cor, posição)
Criar camadas de forma (retângulo, elipse, polígono, estrela) com cores e traços
Criar camadas sólidas/de ajuste para fundos e efeitos
Criar camadas de câmera com zoom e posição configuráveis
Criar objetos nulos para controle de animação
Modificar propriedades de camada como posição, escala, rotação, opacidade, tempo
Alternar modo 2D/3D para camadas
Definir modos de mesclagem (normal, multiplicar, tela, etc.)
Suporte a track matte (alfa, luma, invertido)
Duplicar camadas com renomeação opcional
Excluir camadas da composição
Criar/modificar máscaras com suavização, expansão e opacidade

🌀 Recursos de Animação

Definir quadros-chave para propriedades de camada (Posição, Escala, Rotação, Opacidade, etc.)
Aplicar expressões às propriedades de camada para animações dinâmicas
Definir propriedades em lote em várias camadas de uma só vez

⚙️ Instruções de Configuração

🛠 Pré-requisitos

Adobe After Effects (2022 ou posterior)
Node.js (v14 ou posterior)
Gerenciador de pacotes npm ou yarn

📥 Instalação

Clone o repositório

git clone https://github.com/Dakkshin/after-effects-mcp.git
cd after-effects-mcp

Instale as dependências
```
npm install
# or
yarn install
```
Compile o projeto
```
npm run build
# or
yarn build
```
Instale o painel do After Effects
```
npm run install-bridge
# or
yarn install-bridge
```
Isso copiará os scripts necessários para a sua instalação do After Effects.

🔧 Atualizar Configuração do MCP

Opção 1: Usando .mcp.json (Recomendado para Claude Code)

O repositório inclui um arquivo .mcp.json para configuração fácil. Copie ou faça referência a ele nas suas configurações do MCP:

{
  "mcpServers": {
    "AfterEffectsMCP": {
      "command": "node",
      "args": ["PATH/TO/after-effects-mcp/build/index.js"]
    }
  }
}

Opção 2: Configuração Manual

Vá para o seu cliente (por exemplo, Claude ou Cursor) e atualize o arquivo de configuração:

{
  "mcpServers": {
    "AfterEffectsMCP": {
      "command": "node",
      "args": ["C:\\Users\\Dakkshin\\after-effects-mcp\\build\\index.js"]
    }
  }
}

▶️ Executando o Servidor

Inicie o servidor MCP
```
npm start
# or
yarn start
```
Abra o After Effects
Abra o painel MCP Bridge Auto
- No After Effects, vá em Janela > mcp-bridge-auto.jsx
- O painel verificará automaticamente se há comandos a cada poucos segundos
- Certifique-se de que a caixa de seleção "Executar comandos automaticamente" esteja habilitada

🚀 Guia de Uso

Depois que o servidor estiver em execução e o painel MCP Bridge estiver aberto no After Effects, você poderá controlar o After Effects por meio do protocolo MCP. Isso permite que assistentes de IA ou aplicativos personalizados enviem comandos ao After Effects.

📘 Criando Composições

Você pode criar novas composições com configurações personalizadas:

Nome
Largura e altura (em pixels)
Taxa de quadros
Duração
Cor de fundo

Exemplo de uso da ferramenta MCP (para desenvolvedores):

mcp_aftereffects_create_composition({
  name: "My Composition", 
  width: 1920, 
  height: 1080, 
  frameRate: 30,
  duration: 10
});

✍️ Trabalhando com Camadas

Você pode criar e modificar diferentes tipos de camadas:

Camadas de texto:

Definir conteúdo do texto, fonte, tamanho e cor
Posicionar o texto em qualquer lugar da composição
Ajustar tempo e opacidade

Camadas de forma:

Criar retângulos, elipses, polígonos e estrelas
Definir cores de preenchimento e traço
Personalizar tamanho e posição

Camadas sólidas:

Criar cores de fundo
Criar camadas de ajuste para efeitos

🕹 Animação

Você pode animar camadas com:

Quadros-chave:

Definir valores de propriedade em momentos específicos
Criar movimento, escala, rotação e alterações de opacidade
Controlar o tempo das animações

Expressões:

Aplicar expressões JavaScript às propriedades
Criar animações dinâmicas e procedurais
Conectar valores de propriedade entre si

🛠 Ferramentas MCP Disponíveis

Comando	Descrição
`create-composition`	Criar uma nova composição
`run-script`	Executar um script JS dentro do AE
`get-results`	Obter resultados do script
`get-help`	Ajuda para comandos disponíveis
`setLayerKeyframe`	Adicionar quadro-chave à propriedade da camada
`setLayerExpression`	Adicionar/remover expressões de propriedades
`setLayerProperties`	Definir propriedades da camada (posição, escala, rotação, opacidade, blendMode, threeDLayer, trackMatteType, enabled, etc.)
`batchSetLayerProperties`	Aplicar propriedades a várias camadas
`getLayerInfo`	Obter informações da camada (posição, status 3D)
`createCamera`	Criar camada de câmera
`createNullObject`	Criar objeto nulo para animação
`duplicateLayer`	Duplicar uma camada
`deleteLayer`	Excluir uma camada
`setLayerMask`	Criar/modificar máscaras de camada

👨‍💻 Para Desenvolvedores

🧩 Estrutura do Projeto

src/index.ts: Implementação do servidor MCP
src/scripts/mcp-bridge-auto.jsx: Script principal do painel do After Effects
install-bridge.js: Script para instalar o painel no After Effects

📦 Compilando o Projeto

npm run build
# or
yarn build

Nota: Este projeto usa esbuild para builds rápidos, substituindo a abordagem anterior do compilador TypeScript que podia ficar sem memória em bases de código maiores.

🤝 Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.

Histórico de Estrelas

Licença

Este projeto é licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes.