AE-MCP

Resumen

AE-MCP es un servidor MCP completo que permite a asistentes de IA como Claude controlar directamente Adobe After Effects. Proporciona más de 70 herramientas que cubren todo el flujo de trabajo de gráficos en movimiento, desde la creación de composiciones hasta la aplicación de efectos y expresiones profesionales.

Funcionalidades clave

Related MCP server: After Effects MCP Server

Requisitos

• Adobe After Effects 2024 o posterior

• Node.js 18+

• macOS o Windows

Instalación

Paso 1: Instalar el servidor MCP

git clone https://github.com/anthropics/ae-mcp.git
cd ae-mcp
npm install
npm run build

Paso 2: Instalar la extensión CEP

macOS:

./scripts/install-cep.sh

Windows:

scripts\install-cep.bat

Paso 3: Configurar tu asistente de IA

Añade a tu archivo de configuración:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

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

{
  "mcpServers": {
    "ae-mcp": {
      "command": "node",
      "args": ["/path/to/ae-mcp/dist/index.js"]
    }
  }
}

Añade a tu configuración de MCP (~/.claude/settings.json):

{
  "mcpServers": {
    "ae-mcp": {
      "command": "node",
      "args": ["/path/to/ae-mcp/dist/index.js"]
    }
  }
}

Extra: Este repositorio incluye una Skill de Claude Code para mejorar la automatización de After Effects. Copia los archivos de la skill a tu directorio de skills de Claude Code:

cp -r SKILL/* ~/.claude/skills/

La skill de Claude Code proporciona conocimiento especializado sobre flujos de trabajo de After Effects, formatos de propiedades y buenas prácticas. Consulta SKILL/SKILL.md para más detalles.

Paso 4: Iniciar After Effects

1. Inicia After Effects 2024+

2. Abre Ventana > Extensiones > AE-MCP

3. El panel se iniciará automáticamente y comenzará a escuchar comandos

Categorías de herramientas

Proyecto y composición

create_project · open_project · save_project · close_project · get_project_info · import_footage · create_composition · modify_composition · duplicate_composition · delete_composition · list_compositions · get_composition_info

Creación de capas

add_solid_layer · add_text_layer · add_text_layer_advanced · add_shape_layer · add_null_layer · add_adjustment_layer · add_camera_layer · add_light_layer · add_av_layer · precompose_layers · modify_layer · delete_layer

Animación y fotogramas clave

set_keyframe · set_keyframe_advanced · apply_easy_ease · set_temporal_ease · offset_keyframes · scale_keyframe_timing · reverse_keyframes · copy_keyframes · get_keyframes

Expresiones

set_expression · get_expression · remove_expression · enable_expression · add_expression_control · apply_expression_template · link_properties

Efectos

apply_effect · apply_effect_template · modify_effect_properties · remove_effect · reorder_effects · copy_effects · list_effects

Plantillas de gráficos en movimiento

Gestión de activos

import_folder · replace_footage · organize_project_items · find_missing_footage · collect_files · reduce_project

Marcadores y línea de tiempo

add_composition_marker · add_layer_marker · get_markers · delete_marker · set_work_area

Ejemplos rápidos

Crear una introducción animada

Create a 1920x1080 composition called "Intro" at 30fps, 5 seconds.
Add a text layer saying "Welcome" centered on screen.
Apply a slideInUp animation with easy ease.
Add a subtle glow effect.

Construir un tercero inferior

Create a modern lower third:
- Name: "Sarah Chen"
- Title: "Lead Designer"
- Blue primary color
- Animate in and out
- 5 second duration

Añadir movimiento basado en física

Add a bounce expression to the position of "Logo" layer.
Set amplitude to 0.15, frequency to 4, decay to 6.

Ajustes preestablecidos de animación

Física de resorte (inspirado en Remotion)

Preajustes de movimiento

Fundido: fadeIn · fadeOut Deslizamiento: slideInLeft · slideInRight · slideInUp · slideInDown · slideOutLeft · slideOutRight · slideOutUp · slideOutDown Escalado: scaleIn · scaleOut · scaleInBounce Física: bounce · elastic · overshoot Rotación: spinIn · spinOut

Plantillas de expresiones

Plantillas de efectos

Arquitectura

ae-mcp/
├── src/                          # TypeScript source
│   ├── index.ts                  # Entry point
│   ├── stdio-server.ts           # MCP server (70+ tools)
│   ├── ae-integration/
│   │   ├── file-communicator.ts  # File-based IPC
│   │   └── generators/           # ES3 script generators
│   └── presets/                  # Animation, expression, effect presets
├── cep-extension/                # After Effects extension
│   ├── CSXS/manifest.xml
│   ├── jsx/host.jsx              # ExtendScript host
│   └── js/main.js                # Panel JavaScript
├── SKILL/                        # Claude Code skill
│   ├── SKILL.md                  # Skill definition
│   └── examples.md               # Animation examples
└── scripts/                      # Installation scripts

Flujo de comunicación

AI Assistant (Claude)
        ↓
   MCP Server (Node.js)
        ↓ Write JSON command
   ~/Documents/ae-mcp-commands/
        ↓ Poll every 100ms
   CEP Extension
        ↓ Execute script
   After Effects DOM
        ↓ Write response
   *.json.response

Solución de problemas

1. Verifica que el modo de depuración esté habilitado (el script de instalación lo hace automáticamente)

2. Reinicia After Effects completamente

3. Comprueba la ubicación de la extensión:

   • macOS: ~/Library/Application Support/Adobe/CEP/extensions/ae-mcp

   • Windows: %APPDATA%\Adobe\CEP\extensions\ae-mcp

1. Asegúrate de que el panel de AE-MCP esté visible en After Effects

2. Revisa ~/Documents/ae-mcp-commands/ en busca de archivos de comandos

3. Examina el registro del panel para ver errores

1. Abre el ExtendScript Toolkit o la consola en After Effects

2. Verifica que existan las referencias a composiciones/capas

3. Comprueba problemas de compatibilidad con ES3 (sin funciones flecha, literales de plantilla, etc.)

Contribuciones

¡Las contribuciones son bienvenidas! Por favor, lee nuestras guías de contribución antes de enviar PRs.

Licencia

MIT