Servidor MCP de After Effects
✨ Un servidor de Protocolo de contexto de modelo (MCP) para Adobe After Effects que permite que los asistentes de IA y otras aplicaciones controlen After Effects a través de un protocolo estandarizado.
Tabla de contenido
📦 Características
🎥 Características principales de la composición
- Crea composiciones con configuraciones personalizadas (tamaño, velocidad de fotogramas, duración, color de fondo)
- Enumerar todas las composiciones de un proyecto
- Obtenga información del proyecto , como velocidad de cuadros, dimensiones y duración.
🧱 Gestión de capas
- Crea capas de texto con propiedades personalizables (fuente, tamaño, color, posición)
- Crea capas de formas (rectángulo, elipse, polígono, estrella) con colores y trazos
- Crear capas sólidas/de ajuste para fondos y efectos
- Modificar propiedades de capa como posición, escala, rotación, opacidad y tiempo.
🌀 Capacidades de animación
- Establecer fotogramas clave para las propiedades de capa (Posición, Escala, Rotación, Opacidad, etc.)
- Aplicar expresiones a las propiedades de capa para animaciones dinámicas
⚙️ Instrucciones de configuración
🛠 Requisitos previos
- Adobe After Effects (2022 o posterior)
- Node.js (v14 o posterior)
- gestor de paquetes npm o yarn
📥 Instalación
- Clonar el repositorio
git clone https://github.com/yourusername/after-effects-mcp.git
cd after-effects-mcp
- Instalar dependencias
npm install
# or
yarn install
- Construir el proyecto
npm run build
# or
yarn build
- Instalar el panel After Effects
npm run install-bridge
# or
yarn install-bridge
🔧 Actualizar la configuración de MCP
Vaya a su cliente (por ejemplo, Claude o Cursor) y actualice su archivo de configuración
{
"mcpServers": {
"AfterEffectsMCP": {
"command": "node",
"args": ["C:\\Users\\Dakkshin\\after-effects-mcp\\build\\index.js"]
}
}
}
▶️ Ejecución del servidor
- Iniciar el servidor MCP
npm start
# or
yarn start
- Abrir After Effects
- Abra el panel MCP Bridge Auto
- En After Effects, vaya a Ventana > mcp-bridge-auto.jsx
- El panel comprobará automáticamente si hay comandos cada pocos segundos.
- Asegúrese de que la casilla de verificación "Ejecutar comandos automáticamente" esté habilitada
🚀 Guía de uso
Una vez que el servidor esté en funcionamiento y el panel Puente MCP esté abierto en After Effects, podrá controlar After Effects mediante el protocolo MCP. Esto permite que los asistentes de IA o las aplicaciones personalizadas envíen comandos a After Effects.
📘 Creando composiciones
Puedes crear nuevas composiciones con configuraciones personalizadas:
- Nombre
- Ancho y alto (en píxeles)
- Velocidad de cuadros
- Duración
- Color de fondo
Ejemplo de uso de la herramienta MCP (para desarrolladores):
mcp_aftereffects_create_composition({
name: "My Composition",
width: 1920,
height: 1080,
frameRate: 30,
duration: 10
});
✍️ Trabajando con capas
Puede crear y modificar diferentes tipos de capas:
Capas de texto:
- Establecer el contenido del texto, la fuente, el tamaño y el color
- Coloque el texto en cualquier lugar de la composición
- Ajustar el tiempo y la opacidad
Capas de forma:
- Crea 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
- Crear capas de ajuste para efectos
🕹 Animación
Puedes animar capas con:
Fotogramas clave:
- Establecer valores de propiedad en momentos específicos
- Crear cambios de movimiento, escala, rotación y opacidad
- Controlar el tiempo de las animaciones
Expresiones:
- Aplicar expresiones de JavaScript a las propiedades
- Crea animaciones dinámicas y procedimentales
- Conectar los valores de las propiedades entre sí
🛠 Herramientas MCP disponibles
| Dominio | Descripción |
|---|
| `crear-composición` | Crear una nueva composición |
| `ejecutar script` | Ejecutar un script JS dentro de AE |
| `obtener resultados` | Obtener resultados del script |
| `obtener ayuda` | Ayuda para los comandos disponibles |
| `setLayerKeyframe` | Agregar fotograma clave a la propiedad de capa |
| `setLayerExpression` | Agregar o quitar expresiones de las propiedades |
👨💻 Para desarrolladores
🧩 Estructura del proyecto
src/index.ts : Implementación del servidor MCPsrc/scripts/mcp-bridge-auto.jsx : Script del panel principal de After Effectsinstall-bridge.js : Script para instalar el panel en After Effects
📦 Construyendo el Proyecto
npm run build
# or
yarn build
🤝 Contribuyendo
¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.
Licencia
Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.