Adobe After Effects

Controla Adobe After Effects a través de un protocolo estandarizado, permitiendo a asistentes de IA y otras aplicaciones.

GitHub

681

Prueba este MCPPatrocinado

Documentación

🎬 Servidor MCP de After Effects

License

✨ Un servidor de Protocolo de Contexto de Modelo (MCP) para Adobe After Effects que permite a asistentes de IA y otras aplicaciones controlar After Effects a través de un protocolo estandarizado.

📦 Características

🎥 Características Principales de Composición

Crear composiciones con configuraciones personalizadas (tamaño, velocidad de fotogramas, duración, color de fondo)
Listar todas las composiciones en un proyecto
Obtener información del proyecto como velocidad de fotogramas, dimensiones y duración

🧱 Gestión de Capas

Crear capas de texto con propiedades personalizables (fuente, tamaño, color, posición)
Crear capas de forma (rectángulo, elipse, polígono, estrella) con colores y trazos
Crear capas sólidas/de ajuste para fondos y efectos
Crear capas de cámara con zoom y posición configurables
Crear objetos nulos para control de animación
Modificar propiedades de capas como posición, escala, rotación, opacidad, tiempo
Alternar modo 2D/3D para capas
Establecer modos de fusión (normal, multiplicar, pantalla, etc.)
Soporte de mate de seguimiento (alfa, luminancia, invertido)
Duplicar capas con cambio de nombre opcional
Eliminar capas de la composición
Crear/modificar máscaras con suavizado, expansión y opacidad

🌀 Capacidades de Animación

Establecer fotogramas clave para propiedades de capas (Posición, Escala, Rotación, Opacidad, etc.)
Aplicar expresiones a propiedades de capas para animaciones dinámicas
Establecer propiedades por lotes en múltiples capas a la vez

⚙️ Instrucciones de Configuración

🛠 Requisitos Previos

Adobe After Effects (2022 o posterior)
Node.js (v14 o posterior)
npm o gestor de paquetes yarn

📥 Instalación

Clonar el repositorio

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

Instalar dependencias
```
npm install
# or
yarn install
```
Compilar el proyecto
```
npm run build
# or
yarn build
```
Instalar el panel de After Effects
```
npm run install-bridge
# or
yarn install-bridge
```
Esto copiará los scripts necesarios a tu instalación de After Effects.

🔧 Actualizar Configuración de MCP

Opción 1: Usando .mcp.json (Recomendado para Claude Code)

El repositorio incluye un archivo .mcp.json para configuración fácil. Cópialo o haz referencia a él en tu configuración de MCP:

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

Opción 2: Configuración Manual

Ve a tu cliente (por ejemplo, Claude o Cursor) y actualiza tu archivo de configuración:

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

▶️ Ejecutar el Servidor

Iniciar el servidor MCP
```
npm start
# or
yarn start
```
Abrir After Effects
Abrir el panel automático de MCP Bridge
- En After Effects, ve a Ventana > mcp-bridge-auto.jsx
- El panel verificará automáticamente los comandos cada pocos segundos
- Asegúrate de que la casilla "Ejecutar comandos automáticamente" esté habilitada

🚀 Guía de Uso

Una vez que tengas el servidor ejecutándose y el panel de MCP Bridge abierto en After Effects, puedes controlar After Effects a través del protocolo MCP. Esto permite que asistentes de IA o aplicaciones personalizadas envíen comandos a After Effects.

📘 Crear Composiciones

Puedes crear nuevas composiciones con configuraciones personalizadas:

Nombre
Ancho y alto (en píxeles)
Velocidad de fotogramas
Duración
Color de fondo

Ejemplo de uso de herramienta MCP (para desarrolladores):

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

✍️ Trabajar con Capas

Puedes crear y modificar diferentes tipos de capas:

Capas de texto:

Establecer contenido de texto, fuente, tamaño y color
Posicionar texto en cualquier lugar de la composición
Ajustar tiempo y opacidad

Capas de forma:

Crear rectángulos, elipses, polígonos y estrellas
Establecer colores de relleno y trazo
Personalizar tamaño y posición

Capas sólidas:

Crear colores de fondo
Hacer capas de ajuste para efectos

🕹 Animación

Puedes animar capas con:

Fotogramas clave:

Establecer valores de propiedades en momentos específicos
Crear movimiento, escala, rotación y cambios de opacidad
Controlar el tiempo de las animaciones

Expresiones:

Aplicar expresiones JavaScript a propiedades
Crear animaciones dinámicas y procedimentales
Conectar valores de propiedades entre sí

🛠 Herramientas MCP Disponibles

Comando	Descripción
`create-composition`	Crear una nueva composición
`run-script`	Ejecutar un script JS dentro de AE
`get-results`	Obtener resultados de script
`get-help`	Ayuda para comandos disponibles
`setLayerKeyframe`	Añadir fotograma clave a propiedad de capa
`setLayerExpression`	Añadir/eliminar expresiones de propiedades
`setLayerProperties`	Establecer propiedades de capa (posición, escala, rotación, opacidad, modo de fusión, capa 3D, tipo de mate de seguimiento, habilitado, etc.)
`batchSetLayerProperties`	Aplicar propiedades a múltiples capas
`getLayerInfo`	Obtener información de capa (posición, estado 3D)
`createCamera`	Crear capa de cámara
`createNullObject`	Crear objeto nulo para animación
`duplicateLayer`	Duplicar una capa
`deleteLayer`	Eliminar una capa
`setLayerMask`	Crear/modificar máscaras de capa

👨‍💻 Para Desarrolladores

🧩 Estructura del Proyecto

src/index.ts: Implementación del servidor MCP
src/scripts/mcp-bridge-auto.jsx: Script principal del panel de After Effects
install-bridge.js: Script para instalar el panel en After Effects

📦 Compilar el Proyecto

npm run build
# or
yarn build

Nota: Este proyecto utiliza esbuild para compilaciones rápidas, reemplazando el enfoque anterior del compilador TypeScript que podía quedarse sin memoria en bases de código más grandes.

🤝 Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar una Solicitud de Extracción (Pull Request).

Historial de Estrellas

Licencia

Este proyecto está licenciado bajo la Licencia MIT - consulta el archivo LICENSE para más detalles.