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.

Características principales

Related MCP server: AE 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 habilidad de Claude Code para automatización mejorada de After Effects. Copia los archivos de habilidad a tu directorio de habilidades de Claude Code:

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

La habilidad de Claude Code proporciona conocimiento especializado sobre flujos de trabajo de After Effects, formatos de propiedades y mejores 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 intro 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 tercer 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)

Ajustes de movimiento

Desvanecer: fadeIn · fadeOut Deslizar: slideInLeft · slideInRight · slideInUp · slideInDown · slideOutLeft · slideOutRight · slideOutUp · slideOutDown Escalar: scaleIn · scaleOut · scaleInBounce Física: bounce · elastic · overshoot Girar: 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é activado (el script de instalación lo hace automáticamente)

2. Reinicia After Effects por completo

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. Comprueba ~/Documents/ae-mcp-commands/ para archivos de comando

3. Revisa 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