🎬 After Effects MCP-Server
✨ Ein Model Context Protocol (MCP)-Server für Adobe After Effects, der es KI-Assistenten und anderen Anwendungen ermöglicht, After Effects über ein standardisiertes Protokoll zu steuern.
Inhaltsverzeichnis
📦 Funktionen
🎥 Kernkompositionsfunktionen
- Erstellen Sie Kompositionen mit benutzerdefinierten Einstellungen (Größe, Bildrate, Dauer, Hintergrundfarbe)
- Alle Kompositionen in einem Projekt auflisten
- Erhalten Sie Projektinformationen wie Bildrate, Abmessungen und Dauer
🧱 Ebenenverwaltung
- Erstellen Sie Textebenen mit anpassbaren Eigenschaften (Schriftart, Größe, Farbe, Position)
- Erstellen Sie Formebenen (Rechteck, Ellipse, Polygon, Stern) mit Farben und Strichen
- Erstellen Sie Vollton-/Anpassungsebenen für Hintergründe und Effekte
- Ändern Sie Ebeneneigenschaften wie Position, Skalierung, Drehung, Deckkraft und Timing
🌀 Animationsfunktionen
- Legen Sie Keyframes für Ebeneneigenschaften fest (Position, Skalierung, Drehung, Deckkraft usw.).
- Anwenden von Ausdrücken auf Ebeneneigenschaften für dynamische Animationen
⚙️ Einrichtungsanweisungen
🛠 Voraussetzungen
- Adobe After Effects (2022 oder höher)
- Node.js (v14 oder höher)
- npm oder yarn Paketmanager
📥 Installation
- Klonen Sie das Repository
git clone https://github.com/yourusername/after-effects-mcp.git
cd after-effects-mcp
- Abhängigkeiten installieren
npm install
# or
yarn install
- Erstellen des Projekts
npm run build
# or
yarn build
- Installieren Sie das After Effects-Bedienfeld
npm run install-bridge
# or
yarn install-bridge
🔧 MCP-Konfiguration aktualisieren
Gehen Sie zu Ihrem Client (z. B. Claude oder Cursor) und aktualisieren Sie Ihre Konfigurationsdatei
{
"mcpServers": {
"AfterEffectsMCP": {
"command": "node",
"args": ["C:\\Users\\Dakkshin\\after-effects-mcp\\build\\index.js"]
}
}
}
▶️ Ausführen des Servers
- Starten Sie den MCP-Server
npm start
# or
yarn start
- Öffnen Sie After Effects
- Öffnen Sie das MCP Bridge Auto-Bedienfeld
- Gehen Sie in After Effects zu Fenster > mcp-bridge-auto.jsx
- Das Panel prüft automatisch alle paar Sekunden, ob Befehle verfügbar sind
- Stellen Sie sicher, dass das Kontrollkästchen "Befehle automatisch ausführen" aktiviert ist
🚀 Gebrauchsanweisung
Sobald der Server läuft und das MCP Bridge-Bedienfeld in After Effects geöffnet ist, können Sie After Effects über das MCP-Protokoll steuern. Dadurch können KI-Assistenten oder benutzerdefinierte Anwendungen Befehle an After Effects senden.
📘 Kompositionen erstellen
Sie können neue Kompositionen mit benutzerdefinierten Einstellungen erstellen:
- Name
- Breite und Höhe (in Pixeln)
- Bildrate
- Dauer
- Hintergrundfarbe
Beispiel für die Verwendung des MCP-Tools (für Entwickler):
mcp_aftereffects_create_composition({
name: "My Composition",
width: 1920,
height: 1080,
frameRate: 30,
duration: 10
});
✍️ Arbeiten mit Ebenen
Sie können verschiedene Ebenentypen erstellen und ändern:
Textebenen:
- Textinhalt, Schriftart, Größe und Farbe festlegen
- Positionieren Sie den Text an einer beliebigen Stelle in der Komposition
- Passen Sie Timing und Deckkraft an
Formebenen:
- Erstellen Sie Rechtecke, Ellipsen, Polygone und Sterne
- Füll- und Strichfarben festlegen
- Größe und Position anpassen
Feste Schichten:
- Erstellen Sie Hintergrundfarben
- Erstellen Sie Anpassungsebenen für Effekte
🕹 Animation
Sie können Ebenen mit folgenden Elementen animieren:
Schlüsselbilder:
- Festlegen von Eigenschaftswerten zu bestimmten Zeiten
- Erstellen Sie Bewegungs-, Skalierungs-, Rotations- und Opazitätsänderungen
- Steuern Sie das Timing von Animationen
Ausdrücke:
- Anwenden von JavaScript-Ausdrücken auf Eigenschaften
- Erstellen Sie dynamische, prozedurale Animationen
- Eigenschaftswerte miteinander verknüpfen
| Befehl | Beschreibung |
|---|
| `Komposition erstellen` | Erstellen Sie eine neue Komposition |
| `Skript ausführen` | Führen Sie ein JS-Skript in AE aus |
| `Ergebnisse abrufen` | Abrufen der Skriptergebnisse |
| `Hilfe bekommen` | Hilfe zu verfügbaren Befehlen |
| `setLayerKeyframe` | Keyframe zur Ebeneneigenschaft hinzufügen |
| `setLayerExpression` | Ausdrücke aus Eigenschaften hinzufügen/entfernen |
👨💻 Für Entwickler
🧩 Projektstruktur
src/index.ts : MCP-Serverimplementierungsrc/scripts/mcp-bridge-auto.jsx : Haupt-After Effects-Panel-Skriptinstall-bridge.js : Skript zum Installieren des Panels in After Effects
📦 Erstellen des Projekts
npm run build
# or
yarn build
🤝 Beitragen
Beiträge sind willkommen! Senden Sie gerne einen Pull Request.
Lizenz
Dieses Projekt ist unter der MIT-Lizenz lizenziert – Einzelheiten finden Sie in der Datei LICENSE.