After Effects MCP

Servidor After Effects MCP

Controla Adobe After Effects a través de MCP usando un panel puente que se ejecuta dentro de AE. Este proyecto está optimizado para flujos de trabajo de automatización práctica: efectos, ajustes preestablecidos, animación de fotogramas clave, marcadores y herramientas conscientes del audio.

---

Destacados

• Automatización completa de composiciones y capas.
• Inspección profunda de efectos y edición de propiedades.
• Controles avanzados de gráficos de efectos (temporal + espacial).
• Flujos de trabajo de búsqueda/lista/aplicación de ajustes preestablecidos.
• Automatización de marcadores y audio, incluyendo pipelines de forma de onda a marcadores.
• Descubrimiento de catálogo de efectos instalados (list-available-effects).

Matriz de características

Área	Capacidades
Composición	Crear, inspeccionar proyecto/composiciones, obtener rangos de fotogramas de clips
Capas	Creación de texto/forma/sólido/ajuste, actualizaciones de transformación/propiedades, centrado
Animación	Fotogramas clave de capa, expresiones, fotogramas clave de efectos con controles de gráficos
Efectos	Aplicar por nombre/matchName, listar efectos de capa recursivamente, editar cualquier propiedad de efecto, eliminar efectos
Ajustes preestablecidos	Aplicar .ffx, listar/buscar bibliotecas de ajustes preestablecidos
Marcadores	Añadir marcador único (comp/capa), añadir marcadores en lote
Audio	Establecer niveles de canal, inspeccionar metadatos de audio, analizar forma de onda WAV, detectar picos

Requisitos

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

En After Effects, habilita:

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

Inicio rápido

1. Clona e instala:

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

2. Compila:

npm run build

3. Instala el script puente:

npm run install-bridge

4. Reinicia After Effects y abre:

• Window -> mcp-bridge-auto.jsx
• Mantén este panel abierto durante el uso de MCP.

Configuración del cliente MCP

Usa una ruta absoluta a build/index.js.

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

Añadir a VS Code

Si usas una extensión de VS Code compatible con MCP, añade este servidor en la configuración de servidores MCP de esa extensión.

Usa:

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

Ejemplo de fragmento que muchas extensiones aceptan:

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

Luego:

1. Reinicia VS Code.
2. Abre After Effects y mantén Window -> mcp-bridge-auto.jsx abierto.
3. Llama a una herramienta simple como get-help o run-script con getProjectInfo.

Añadir a Claude Desktop

Edita la configuración de Claude Desktop y añade la entrada del servidor MCP.

Ubicación típica de configuración en Windows:

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

Ejemplo:

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

Después de guardar:

1. Reinicia completamente Claude Desktop.
2. Abre el panel puente de AE.
3. Verifica con tools/list en los registros o llamando a una herramienta conocida.

Añadir a Claude Code

Configura el mismo comando/args del servidor en tu configuración MCP de Claude Code.

Usa esta definición de servidor:

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

Luego:

1. Reinicia Claude Code o recarga los servidores MCP.
2. Asegúrate de que After Effects esté abierto con el panel mcp-bridge-auto.jsx ejecutándose.
3. Prueba con get-results después de un comando en cola.

Gráfico de arquitectura

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

Gráfico de flujo 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

Flujo de ejecución típico

1. Inicia tu cliente MCP (inicia este servidor).
2. Mantén abierto el panel puente de AE.
3. Llama a las herramientas.
4. Si la respuesta dice "en cola", llama a get-results después de 1-3 segundos.

Nota: algunas operaciones de AE terminan ligeramente después de las ventanas de tiempo de espera de las herramientas; get-results suele contener el estado final.

Catálogo de herramientas

General

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

Utilidades de composición y capas

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

Efectos y ajustes preestablecidos

• 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 y audio

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

Diagnóstico y ayudas

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

Flujo de trabajo de audio a marcadores

1. get-audio-info en la capa objetivo.
2. Copia sourceFilePath.
3. analyze-audio-waveform con numPoints opcional.
4. Convierte peakTimes a markers[].
5. add-markers-bulk.

Estructura del proyecto

• src/index.ts - servidor MCP y definiciones de herramientas
• src/scripts/mcp-bridge-auto.jsx - panel puente de AE
• install-bridge.js - instalador del puente

Desarrollo

Compilar:

npm run build

Instalar puente:

npm run install-bridge

Ejecutar servidor directamente:

node build/index.js

Solución de problemas

El servidor no se inicia

• Ejecuta npm run build.
• Revisa los registros de MCP para ver excepciones de inicio (por ejemplo, registro duplicado de herramientas).

Los comandos se ponen en cola pero no se completan

• Asegúrate de que el panel puente de AE esté abierto.
• Confirma que el permiso de scripting/red de AE esté habilitado.
• Reintenta y llama a get-results después de un breve retraso.

Los resultados parecen desactualizados

• Vuelve a abrir el panel puente.
• Envía un nuevo comando y luego llama a get-results.

La instalación en Program Files falla

• Esperado sin permisos elevados.
• Las rutas de script en AppData del usuario suelen ser suficientes.

Licencia

MIT. Ver LICENSE.

Inspiración

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

Tomé el código base de ellos pero añadí mucho