ae-mcp

English | 简体中文

Indicación de configuración en una línea — pégala en Claude Code u otro agente de IA:

Install the ae-mcp ZXP and the native plug-in for my platform from the v0.10.3
release, open Window > Extensions
> ae-mcp in After Effects, then connect Claude Code with `claude mcp add
--transport http ae http://127.0.0.1:11488/mcp`; for Claude Desktop, configure
the extension's `host/stdio-shim.js` with the system Node executable and ask me
to start a new client session before testing `ae_status`.

ae-mcp conecta un panel CEP de After Effects con clientes de IA a través de un endpoint MCP local. El panel aloja el servicio en http://127.0.0.1:11488/mcp; el host es un proceso Node que usa Express, y el estado de After Effects se alcanza mediante ExtendScript y el plano nativo AEGP congelado.

Instalación y primera ejecución

1. Instala el ZXP firmado en After Effects.

2. Instala el complemento nativo correspondiente junto a los complementos de After Effects seleccionados para el host: el .aex en Windows y el paquete AeMcpNative.plugin en macOS. Mantén el par de versiones del mismo lanzamiento. El ZXP no incluye binarios de plataforma y se instala en ambos sistemas; solo este complemento nativo se compila por plataforma, y ae_nativeExec es la única herramienta que lo necesita. Instalación indica la ubicación exacta por plataforma; además, en el paquete de macOS hay que eliminar la cuarentena de descarga antes de que After Effects lo cargue.

3. Inicia After Effects y abre Window > Extensions > ae-mcp. Mantén el panel abierto mientras un cliente externo usa MCP.

4. Configura una de las dos formas de conexión externa admitidas que se muestran a continuación.

El panel en sí mismo es el servicio MCP. No se necesita ningún servidor de repositorio separado. Los clientes externos deben ejecutarse en la misma máquina que After Effects porque el endpoint por defecto es de bucle local.

Related MCP server: After Effects MCP

Conexiones de clientes

Claude Code usa el transporte URL:

claude mcp add --transport http ae http://127.0.0.1:11488/mcp

Claude Desktop puede usar el conector publicado mediante la instalación de Node del sistema, sin necesidad de acceder al directorio de la extensión instalada. Esta forma npx -y ae-mcp-jkdg envuelve el mismo host/stdio-shim.js sin dependencias:

{
  "mcpServers": {
    "ae": {
      "command": "npx",
      "args": ["-y", "ae-mcp-jkdg"]
    }
  }
}

Alternativamente, Claude Desktop puede ejecutar el shim stdio sin dependencias incluido en la extensión instalada. Establece command en el ejecutable de Node del sistema y apunta args al host/stdio-shim.js del directorio de la extensión:

{
  "mcpServers": {
    "ae": {
      "command": "node",
      "args": ["<installed-extension>/host/stdio-shim.js"],
      "env": {
        "AE_MCP_HTTP_URL": "http://127.0.0.1:11488/mcp"
      }
    }
  }
}

Claude Desktop, por lo tanto, necesita una instalación de Node del sistema. El shim mantiene una cola de peticiones stdio y reenvía las respuestas MCP al host del panel.

Capacidades del panel

• ae_exec para operaciones ExtendScript mantenidas.

• ae_execRecover para reintentar un fallo de ae_exec enviado mediante su id devuelto.

• ae_nativeExec para las primitivas nativas congeladas de AEGP.

• ae_previewFrame, ae_validateExpressions, ae_read estructurado y puntos de control.

• Habilidades incluidas más la Biblioteca de Herramientas JSX local.

• Modos de aprobación, historial de actividad, diagnósticos y exportación de logs.

• Canales integrados de Claude, Codex y OpenCode cuando su inicio de sesión CLI local está disponible.

El host CEP sirve las herramientas públicas de MCP. Las escrituras deben ir seguidas de una lectura de verificación independiente; los fallos con posibles efectos secundarios deben reconciliarse antes de reintentar, y Deshacer debe ejecutarse y verificarse por separado.

Desarrollo

Instala los dos espacios de trabajo de Node y compila el panel:

(cd plugin/host && npm ci)
(cd plugin/panel && npm ci && npm run build)

Para un despliegue CEP local, usa el script específico de la plataforma después de que el host y el panel estén compilados:

.\scripts\install-plugin-dev.ps1

./scripts/install-plugin-dev-macos.sh

El Adobe After Effects C/C++ Plug-in SDK es una entrada proporcionada por el desarrollador y debe permanecer fuera de este repositorio. Verifícalo antes de compilar el complemento nativo:

node scripts/package/ae-sdk-input.mjs verify-input --platform macos-arm64

Para el plano nativo congelado, compila en un directorio nuevo fuera del repositorio. El instalador mantiene el estado de la transacción bajo native-plugin-dev-v1; conserva el ID de transacción devuelto si instalas el resultado:

AE_SDK_ARCHIVE=/absolute/path/AfterEffectsSDK.zip
AE_SDK_ROOT=/absolute/path/AfterEffectsSDK
BUILD_DIR=/private/tmp/ae-mcp-native-dev
TRANSACTION_ID="paste-the-transaction-id-here"
node native/ae-plugin/build-macos.mjs \
  --sdk-archive "$AE_SDK_ARCHIVE" \
  --sdk-root "$AE_SDK_ROOT" \
  --output "$BUILD_DIR"
# The install state root is native-plugin-dev-v1.
node native/ae-plugin/install-dev-macos.mjs install --artifact-dir "$BUILD_DIR"
node native/ae-plugin/install-dev-macos.mjs rollback \
  --transaction "$TRANSACTION_ID"

El plano nativo está congelado; los archivos de protocolo AEGP generados están incluidos en el repositorio, y la canalización de generación de código del paquete de capacidades no forma parte del desarrollo normal.

Pruebas y empaquetado

Ejecuta localmente las pruebas de contrato de Node específicas:

node --test scripts/package/test/verify-windows-zxp-stage.test.mjs
node --test scripts/package/test/zxp-payload-audit.test.mjs

El comando de preparación del ZXP para Windows copia solo el panel, el host, el JSX, los módulos compartidos, los iconos y los activos generados del host. Verifica la dependencia exacta de Express 4.22.2 del host y firma el ZXP una vez:

.\scripts\package-zxp.ps1 -SkipSigning

El ZXP firmado no debe contener ningún binario nativo anidado salvo un artefacto .aex manejado explícitamente, y debe mantenerse por debajo de 20 MB.

Consulta Instalación, Referencia y Lanzamiento para los detalles operativos mantenidos al día.

Licencia

ae-mcp se publica bajo la Licencia MIT; consulta LICENSE. El CSInterface.js de Adobe conserva su aviso de licencia original.