ae-mcp

English | 简体中文

Einzeiliger Setup-Prompt – fügen Sie diesen in Claude Code oder einen anderen KI-Agenten ein:

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 verbindet ein After Effects CEP-Bedienfeld über einen lokalen MCP-Endpunkt mit KI-Clients. Das Bedienfeld hostet den Dienst unter http://127.0.0.1:11488/mcp; der Host ist ein Node-Prozess, der Express verwendet, und der Zustand von After Effects wird über ExtendScript und die eingefrorene native AEGP-Ebene erreicht.

Installation und erster Start

1. Installieren Sie die signierte ZXP in After Effects.

2. Installieren Sie das passende native Plug-in neben den für den Host ausgewählten After Effects-Plug-ins – die .aex unter Windows, das Bundle AeMcpNative.plugin unter macOS. Verwenden Sie das Versionspaar aus demselben Release. Die ZXP enthält keine Plattform-Binärdateien und lässt sich auf beiden Systemen installieren; nur dieses native Plug-in wird pro Plattform gebaut, und ae_nativeExec ist das einzige Werkzeug, das es benötigt. Installation enthält das genaue Zielverzeichnis pro Plattform, und das macOS-Bundle muss zusätzlich aus der Download-Quarantäne befreit werden, bevor After Effects es lädt.

3. Starten Sie After Effects und öffnen Sie Fenster > Erweiterungen > ae-mcp. Lassen Sie das Bedienfeld geöffnet, während ein externer Client MCP verwendet.

4. Konfigurieren Sie eine der beiden unten unterstützten externen Verbindungsarten.

Das Bedienfeld selbst ist der MCP-Dienst. Es wird kein separater Repository-Server benötigt. Externe Clients müssen auf demselben Rechner wie After Effects laufen, da der Standard-Endpunkt Loopback ist.

Related MCP server: After Effects MCP Server

Client-Verbindungen

Claude Code verwendet den URL-Transport:

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

Claude Desktop kann den veröffentlichten Connector über die systemweite Node-Installation verwenden, ohne Zugriff auf das installierte Erweiterungsverzeichnis zu benötigen. Diese npx -y ae-mcp-jkdg-Form kapselt dasselbe abhängigkeitsfreie host/stdio-shim.js:

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

Alternativ kann Claude Desktop den in der installierten Erweiterung enthaltenen abhängigkeitsfreien Stdio-Shim ausführen. Setzen Sie command auf die systemweite Node-Binärdatei und richten Sie args auf host/stdio-shim.js im Erweiterungsverzeichnis:

{
  "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 benötigt daher eine systemweite Node-Installation. Der Shim hält eine Stdio-Anfragewarteschlange vor und leitet MCP-Antworten an den Host des Bedienfelds weiter.

Funktionen des Bedienfelds

• ae_exec für die gepflegten ExtendScript-Operationen.

• ae_execRecover zum Wiederholen eines übermittelten ae_exec-Fehlers anhand der zurückgegebenen id.

• ae_nativeExec für die eingefrorenen nativen AEGP-Primitive.

• ae_previewFrame, ae_validateExpressions, strukturiertes ae_read und Checkpoints.

• Mitgelieferte Skills sowie die lokale JSX Tool Library.

• Genehmigungsmodi, Aktivitätsverlauf, Diagnose und Log-Export.

• Integrierte Claude-, Codex- und OpenCode-Kanäle, wenn deren lokaler CLI-Login verfügbar ist.

Die öffentlichen MCP-Werkzeuge werden vom CEP-Host bereitgestellt. Auf Schreibvorgänge sollte ein unabhängiges Rücklesen folgen; potenziell nebenwirkende Fehler müssen vor einem erneuten Versuch abgeglichen werden, und Undo muss separat ausgeführt und verifiziert werden.

Entwicklung

Installieren Sie die beiden Node-Workspaces und bauen Sie das Bedienfeld:

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

Für eine lokale CEP-Bereitstellung verwenden Sie das plattformspezifische Skript, nachdem Host und Bedienfeld gebaut wurden:

.\scripts\install-plugin-dev.ps1

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

Das Adobe After Effects C/C++ Plug-in SDK ist eine vom Entwickler bereitgestellte Eingabe und muss außerhalb dieses Repositorys bleiben. Verifizieren Sie es, bevor Sie das native Plug-in bauen:

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

Bauen Sie für die eingefrorene native Ebene in ein neues Verzeichnis außerhalb des Repositorys. Der Installer speichert den Transaktionsstatus unter native-plugin-dev-v1; bewahren Sie die zurückgegebene Transaktions-ID auf, wenn Sie das Ergebnis installieren:

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"

Die native Ebene ist eingefroren; generierte AEGP-Protokolldateien sind eingecheckt, und die Codegenerierungs-Pipeline für das capability-package ist nicht Teil der normalen Entwicklung.

Tests und Paketierung

Führen Sie fokussierte Node-Verträge lokal aus:

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

Der Windows-ZXP-Staging-Befehl kopiert nur das Bedienfeld, den Host, JSX, gemeinsame Module, Symbole und generierte Host-Assets. Er verifiziert die exakte Express-Abhängigkeit 4.22.2 des Hosts und signiert die ZXP einmal:

.\scripts\package-zxp.ps1 -SkipSigning

Die signierte ZXP darf keine verschachtelte native Binärdatei außer einem explizit behandelten .aex-Artefakt enthalten und muss unter 20 MB bleiben.

Siehe Installation, Referenz und Release für die aktuell gepflegten Betriebsdetails.

Lizenz

ae-mcp wird unter der MIT-Lizenz veröffentlicht; siehe LICENSE. Adobes CSInterface.js behält ihren Upstream-Lizenzhinweis bei.