After Effects MCP

After Effects MCP

Servidor MCP local para controlar Adobe After Effects desde OpenCode, ClaudeDesktop, Claude Code, ChatGPT Desktop con Codex, Codex CLI, Cursor y otrosclientes compatibles con Model Context Protocol.

Permite inspeccionar proyectos, crear composiciones, agregar capas, importararchivos, ejecutar ExtendScript y renderizar con aerender. Funciona porstdio, no abre puertos de red y procesa las operaciones JSX en serie.

Repositorio: https://github.com/leo10m2010/mcp-after

Para una IA que recibe este enlace

Lee AGENTS.md y docs/CLIENTS.md. Detecta elcliente del usuario, aplica solo la configuracion correspondiente, conserva suconfiguracion existente y verifica la conexion antes de modificar After Effects.

Prompt que un usuario puede entregar a otra IA:

Instala y configura este MCP de After Effects para el cliente que estoy usando:
https://github.com/leo10m2010/mcp-after
Sigue AGENTS.md, conserva mi configuracion actual y verifica la conexion.

Compatibilidad

ChatGPT Desktop con Codex, Codex CLI y la extension IDE comparten la mismaconfiguracion MCP. ChatGPT web no lee la configuracion local.

Requisitos

• Windows 10 u 11.
• Node.js 20 o superior.
• Adobe After Effects instalado.
• En After Effects, activar:Preferencias > Secuencias de comandos y expresiones > Permitir que las secuencias de comandos escriban archivos y accedan a la red.

El servidor detecta automaticamente la version mas reciente instalada enC:\Program Files\Adobe.

Generar la configuracion

No es necesario clonar el repositorio. El ejecutable imprime la configuracioncorrecta para cada cliente:

npx -y github:leo10m2010/mcp-after --print-config opencode
npx -y github:leo10m2010/mcp-after --print-config claude-desktop
npx -y github:leo10m2010/mcp-after --print-config claude-code
npx -y github:leo10m2010/mcp-after --print-config cursor
npx -y github:leo10m2010/mcp-after --print-config codex
npx -y github:leo10m2010/mcp-after --print-config codex-toml
npx -y github:leo10m2010/mcp-after --print-config chatgpt-desktop
npx -y github:leo10m2010/mcp-after --print-config chatgpt

Instalacion por cliente

OpenCode

Combina este bloque con opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "after-effects": {
      "type": "local",
      "command": ["npx", "-y", "github:leo10m2010/mcp-after"],
      "enabled": true
    }
  }
}

Reinicia OpenCode y verifica:

opencode mcp list

Archivo listo: examples/opencode.json.

Claude Desktop para Windows

1. Abre Claude Desktop.
2. Entra a Settings > Developer > Edit Config.
3. Claude abre %APPDATA%\Claude\claude_desktop_config.json.
4. Combina el siguiente servidor dentro de mcpServers sin borrar otros MCP.

{
  "mcpServers": {
    "after-effects": {
      "command": "npx",
      "args": ["-y", "github:leo10m2010/mcp-after"]
    }
  }
}

5. Cierra Claude Desktop completamente y vuelve a abrirlo.
6. En el cuadro de mensaje, abre Connectors > Manage connectors y confirmaque after-effects muestra sus herramientas.

Archivo listo:examples/claude-desktop.json.

Claude Code

Instalacion para todos los proyectos del usuario:

claude mcp add --scope user --transport stdio after-effects -- npx -y github:leo10m2010/mcp-after
claude mcp list

Abre una nueva sesion de Claude Code y usa /mcp para comprobar el servidor.

ChatGPT Desktop con Codex

La app de escritorio de ChatGPT con Codex admite servidores locales stdio.Puede configurarse de dos formas:

1. Abre Settings > MCP servers > Add server.
2. Elige STDIO.
3. Nombre: after-effects.
4. Comando: npx.
5. Argumentos: -y y github:leo10m2010/mcp-after.
6. Guarda y selecciona Restart.

Alternativamente, instala desde una terminal:

codex mcp add after-effects -- npx -y github:leo10m2010/mcp-after
codex mcp list

La app de ChatGPT Desktop, Codex CLI y la extension Codex comparten~/.codex/config.toml. Configurar una de ellas configura las otras en el mismohost. En la interfaz, usa /mcp para ver el servidor.

Codex CLI o extension IDE

codex mcp add after-effects -- npx -y github:leo10m2010/mcp-after
codex mcp list

Configuracion TOML equivalente:

[mcp_servers.after-effects]
command = "npx"
args = ["-y", "github:leo10m2010/mcp-after"]
startup_timeout_sec = 30
tool_timeout_sec = 3600
default_tools_approval_mode = "writes"

Archivo listo: examples/codex.toml.

Cursor

Crea o combina .cursor/mcp.json:

{
  "mcpServers": {
    "after-effects": {
      "command": "npx",
      "args": ["-y", "github:leo10m2010/mcp-after"]
    }
  }
}

Reinicia Cursor. Archivo listo: examples/cursor.json.

ChatGPT web

ChatGPT web no puede iniciar este proceso local ni leer ~/.codex/config.toml.Las apps MCP de la web requieren un endpoint remoto HTTPS.

Este servidor incluye after_effects_run_jsx, que puede ejecutar codigo yacceder a archivos locales. No lo publiques mediante un tunel abierto. Para usarmodelos OpenAI con el After Effects de la misma computadora, usa ChatGPT Desktopcon Codex o Codex CLI.

Una version remota requiere otro componente con HTTPS, autenticacion, permisos,restricciones de herramientas y acceso seguro a la computadora donde correAfter Effects. Consulta ladocumentacion oficial de MCP para ChatGPT.

Cambiar de proveedor o modelo

El MCP es independiente del proveedor. No contiene claves de OpenAI o Anthropicy no selecciona el modelo. El cliente decide que modelo llama las herramientas.

En OpenCode:

1. Ejecuta opencode models.
2. Selecciona un identificador disponible, por ejemplo uno con prefijoopenai/ o anthropic/.
3. Cambia el campo model o usa el selector de modelos.
4. Conserva intacto mcp.after-effects.
5. Reinicia OpenCode si modificaste opencode.json.

En Claude, el proveedor lo gestiona Claude. En Codex y ChatGPT Desktop conCodex, el proveedor lo gestiona OpenAI. Cambiar de cliente no requiere reinstalarel MCP; solo agrega la misma orden npx en el nuevo cliente.

Instalacion global opcional

npm install --global github:leo10m2010/mcp-after

Despues puede usarse after-effects-mcp en lugar de npx -y ...:

{
  "command": "after-effects-mcp"
}

Herramientas

Ejemplos de uso

Inspecciona el proyecto abierto de After Effects y dime que composiciones tiene.

Crea una composicion 1920x1080 de 10 segundos y agrega un titulo animado.

Importa C:\Recursos\logo.svg y usalo en la composicion Final.

Guarda el proyecto y renderiza la composicion Final en C:\Renders\final.mov.

El agente debe inspeccionar el proyecto antes de editar. Guardar, descartarcambios o renderizar requiere una solicitud expresa del usuario.

Rutas personalizadas

• AFTER_EFFECTS_PATH: ruta absoluta de AfterFX.exe.
• AFTER_EFFECTS_RUNNER_PATH: ejecutable usado para enviar JSX.
• AERENDER_PATH: ruta absoluta de aerender.exe.

Estas variables se agregan en env dentro de la configuracion MCP del cliente.

Diagnostico

node --version
npx --version
npx -y github:leo10m2010/mcp-after --version
npx -y github:leo10m2010/mcp-after --print-config opencode

Problemas comunes:

• Si aparece npx ENOENT, ejecuta where.exe npx y usa la ruta de npx.cmd.
• Si After Effects no aparece, configura AFTER_EFFECTS_PATH.
• Si JSX no responde, activa el permiso de scripts en Preferencias de Adobe.
• Si el cliente no muestra herramientas, cierralo completamente y reinicialo.
• Claude Desktop escribe logs MCP en %APPDATA%\Claude\logs.

Consulta la guia ampliada en docs/CLIENTS.md.

Desarrollo

git clone https://github.com/leo10m2010/mcp-after.git
cd mcp-after
npm ci
npm test
npm run smoke

• npm test valida sintaxis, configuraciones y protocolo sin After Effects.
• npm run smoke comprueba la instalacion local sin abrir After Effects.
• npm run smoke -- --live ejecuta lecturas reales.
• npm run smoke -- --live --new-project modifica el estado de la aplicacion ysolo debe usarse con un proyecto limpio.

Seguridad

• El servidor local no abre puertos.
• No guarda claves de proveedor.
• Abrir o reemplazar proyectos rechaza cambios sin guardar por defecto.
• Guardar, descartar y renderizar deben ser acciones solicitadas por el usuario.
• after_effects_run_jsx tiene acceso amplio a After Effects y archivos locales.
• No expongas este servidor directamente a Internet.

Licencia

MIT