ae-mcp

Ein fortschrittlicher MCP-Server für Adobe After Effects. Er gibt einem Assistenten eine Editor-Werkzeugkiste an die Hand: ein Projekt lesen, Ebenen erstellen und riggen, Keyframes mit echten Geschwindigkeitskurven setzen, Text animieren, Vektorformen bauen, Effekte und Ausdrücke anwenden, native Menüs steuern — und das Ergebnis sehen durch Snapshots, die direkt in die Konversation zurückgegeben werden.

Architektur

Assistant (MCP)
      │  stdio
┌─────▼──────────────────────────────┐
│  ae-mcp server (Node/TypeScript)   │   easing, SVG, presets, schemas
└─────┬──────────────────────────────┘
      │  1. HTTP 127.0.0.1:9782  (CEP transport, primary)
      │  2. watched JSON files    (ScriptUI transport, fallback)
┌─────▼──────────────────────────────┐
│  bridge inside After Effects       │   CEP panel or ScriptUI panel
└─────┬──────────────────────────────┘
      │  $.evalFile + AEMCP.runFile()
┌─────▼──────────────────────────────┐
│  ExtendScript kernel (AEMCP)       │   ~4,000 lines, 60+ commands
└────────────────────────────────────┘

Drei Prinzipien:

• Die schwere Arbeit bleibt in Node. SVG-Konvertierung, Easing-Mathematik, Animations-Presets — alles serverseitig vorbereitet; der ExtendScript-Kernel führt nur aus.

• Der Austausch läuft über Dateien. Anfragen und Antworten reisen als JSON auf der Festplatte und umgehen damit evalScript-Escape- und Größenlimits. HTTP löst nur die Ausführung aus.

• Alles ist atomar. Jede Anfrage — selbst ein Stapel von 50 Operationen — läuft innerhalb einer einzigen Undo-Gruppe: ein Ctrl+Z macht alles rückgängig.

Bridge-Authentifizierungstoken

Der HTTP-Server des CEP-Panels lauscht auf 127.0.0.1 und löst Befehle in After Effects aus (einschließlich ae_eval, das beliebiges ExtendScript ausführt). Damit eine im Browser geöffnete Webseite die Bridge nicht über ein simples fetch() steuern kann, während AE läuft, erzeugt das Panel beim ersten Start ein zufälliges Token, das in Documents/ae-mcp/bridge/token.txt gespeichert und in bridge.json (Feld token) veröffentlicht wird. Jeder POST /run- oder POST /reload-Aufruf muss den X-AE-MCP-Token-Header enthalten; ohne ihn liefert der Server 401. Der MCP-Client (src/bridge/client.ts) liest das Token aus bridge.json und sendet es automatisch — keine manuelle Einrichtung nötig. Das Token bleibt bestehen, solange token.txt existiert; löschen Sie die Datei, um beim nächsten Panel-Start eine Neuerzeugung zu erzwingen.

Der Fallback-Dateitransport (req//res/) hat kein Token: Er verlässt sich auf die OS-Berechtigungen des Documents-Ordners des Benutzers, die den Zugriff von einem anderen Konto bereits blockieren.

Related MCP server: After Effects MCP Server

Installation

npm install
npm run build
npm run install-bridge      # installs the CEP extension + ScriptUI panel + kernel

Dann in After Effects:

• CEP-Transport (empfohlen) — starten Sie After Effects neu. Die Bridge startet von selbst, ohne Fenster. Window > Extensions > AE MCP Bridge zeigt Status, Port und Log.

• ScriptUI-Transport (ohne Neustart) — File > Scripts > Run Script File… wählen und dann Documents/ae-mcp/AE MCP Bridge.jsx auswählen. Das Panel beginnt sofort mit dem Polling.

Registrieren Sie den Server bei Ihrem MCP-Client:

claude mcp add ae-mcp -- node "/path/to/ae-mcp/build/index.js"

npm run install-bridge kopiert das Panel außerdem in Scripts/ScriptUI Panels jeder erkannten After-Effects-Installation, sodass es andockbar ist. Diese Kopie liegt unter Program Files und benötigt Administratorrechte; falls dies fehlschlägt, wird nichts anderes beeinträchtigt.

Werkzeuge

Was es besonders macht

Echte Geschwindigkeitskurven. ease: "expo.out" wendet nicht nur Easy Ease an — die Bézier-Kurve wird in Einfluss und Geschwindigkeit pro Dimension umgewandelt, berechnet aus der durchschnittlichen Geschwindigkeit des Segments, genau wie beim manuellen Feinjustieren im Graph-Editor.

Relative Werte. Ein slideIn verwendet mode: "offset": Die Animation baut auf der vorhandenen Position der Ebene auf, statt sie zu überschreiben. Dieselbe Idee für die Skalierung mit mode: "multiply".

SVG wird zu echten Formen. ae_shape action=svg wandelt path, rect, circle, ellipse, line, polyline, polygon, Gruppen und deren Transformationen in native, bearbeitbare Formebenen um, mit Füllungen, Konturen, Strichelungen und in Bézier angenäherten Bögen.

Eine visuelle Rückkopplungsschleife. ae_render action=snapshot rendert die Komposition und gibt das Bild direkt zurück: Der Assistent vergleicht seine Ausgabe mit der Referenz und korrigiert, statt blind zu arbeiten.

Atomare Stapel mit Referenzen. Eine ganze Szene entsteht in einem einzigen Roundtrip, wobei jeder Schritt das Ergebnis des vorherigen über {{0.index}} oder {{prev.id}} wiederverwenden kann.

Entwicklung

npm run build          # kernel + TypeScript
npm run build:kernel   # kernel only (also checks its syntax)
node scripts/ae.mjs status                       # bridge status
node scripts/ae.mjs layer.list '{"comp":"My Comp"}'
node scripts/selftest.mjs                        # full validation against AE
node scripts/selftest.mjs --keep --only=shape    # subset, keeps the comp

Der Kernel ist in Module unter host/kernel/ aufgeteilt und wird von scripts/build-kernel.mjs zu host/aemcp-kernel.jsx zusammengefügt. Er muss ES3-kompatibel bleiben: kein let/const, kein Array.prototype.map, kein natives JSON (ein Polyfill ist im Prelude enthalten).

Fehlerbehebung