79 lines
4.6 KiB
Markdown
79 lines
4.6 KiB
Markdown
---
|
||
name: effectcraft-mcp
|
||
description: "Motion-Graphics und Compositings (.ecproj) mit dem EffectCraft-MCP-Server aufbauen, keyframen und rendern. Verwenden, wenn EffectCraft-Werkzeuge verbunden sind oder der Nutzer EffectCraft nennt; typisch für Titel, Bauchbinden, einfache Animationen, Standbilder und Filmexporte. Nicht für den Schnitt einer Timeline aus Clips (FilmCraft)."
|
||
---
|
||
|
||
# Compositing mit EffectCraft (MCP)
|
||
|
||
EffectCraft ist ein Compositor im Stil von After Effects (Rust). CLI 0.17.0. Zeiten sind Sekunden. Projektdatei `.ecproj`.
|
||
|
||
## Voraussetzung
|
||
|
||
Die Werkzeuge `list_commands`, `execute_command`, `get_project`, `set_property`, `render_preview` … müssen verbunden sein. Fehlen sie, dem Nutzer sagen, dass der Server nicht verbunden ist (Einrichtung siehe README).
|
||
|
||
Start, wie die CLI es verlangt:
|
||
|
||
- Kopflos: `effectcraft-cli mcp`, dazu `--empty`, `--demo` oder `--project F.ecproj`. `--empty` zusammen mit beiden Ordner-Flags ist geprüft (Server kommt hoch).
|
||
- `--autosave` oder `--bridge PORT`, nicht beides. `--bridge PORT` hängt an der App. Die globale Option heißt ebenfalls `--bridge PORT`.
|
||
- `--automation-read-root` und `--automation-write-root` (je mehrfach). Lesen im Lese- oder Schreib-Ordner, Schreiben nur im Schreib-Ordner. Die Hilfe sagt an dieser Stelle, Skripte werden abgelehnt. `run_script` mit gesetzten Ordnern ist nicht extra probiert.
|
||
|
||
## Werkzeuge
|
||
|
||
| Tool | Zweck |
|
||
|---|---|
|
||
| `list_commands {filter}` / `describe_command` | Befehls-IDs. Nie raten. `command_list` ist derselbe Katalog |
|
||
| `execute_command {command, params}` | ein Befehl. `command_run` nimmt stattdessen `{id, params}` |
|
||
| `batch {steps}` | mehrere Befehle, ein Undo. `"$1.layer"` meint das Feld `layer` aus Schritt 1 |
|
||
| `command_batch` | mehrere Befehle, je ein eigenes Undo |
|
||
| `get_project` / `get_comp` / `get_layer` / `get_property` | nachlesen. Pfade wie `transform/position`, `effects/#1/blurriness` |
|
||
| `set_property` / `add_keyframe` / `add_effect` | Wert, Keys, Effekt (`Gaussian Blur` oder eine ID aus `list_effects`) |
|
||
| `render_frame` / `render_preview` | PNG der Komposition |
|
||
| `open_project` / `save_project` | `.ecproj`, `demo` oder `new` |
|
||
| `undo` / `redo` / `history` | Verlauf, `history.goto` springt auch auf einen Zweig |
|
||
| `run_script {code}` | JavaScript im After-Effects-Objektmodell |
|
||
| `list_effects` / `list_fonts` / `get_state` | Kataloge und wo der Abspielkopf steht |
|
||
| `doc_inspect` | Projekt plus aktive Komposition |
|
||
| `script_ui` | Fenster, die ein Skript geöffnet hat |
|
||
|
||
## Arbeitsweise
|
||
|
||
1. **Leer starten oder die genannte `.ecproj` öffnen.** Nicht raten, welches Projekt offen ist: `get_project`.
|
||
2. **Komposition, dann Ebenen, dann Keys.** Beispiel aus der Werkzeugbeschreibung: `comp.new`, `layer.newText` oder `layer.newSolid`, `set_property` / `add_keyframe`, `effect.apply`.
|
||
3. **`render_preview` nach jedem größeren Schritt.**
|
||
4. **Speichern** als `.ecproj` unter neuem Namen. Eine Filmdatei ist ein eigener Schritt.
|
||
|
||
CLI-Export (`render`), Formate: h264, hevc, av1, prores, webm, png, jpeg, tiff, exr, gif, wav, aiff. Ein Standbild: `render-frame`. Ob jedes Format auf diesem Rechner einen Encoder hat, ist nicht geprüft.
|
||
|
||
## Fallen
|
||
|
||
- **Zwei Lauf-Werkzeuge.** `execute_command` will `command`. `command_run` will `id`. Dieselbe ID, anderes Feld.
|
||
- **`batch` rollt zurück, `command_batch` nicht als eine Gruppe.** Für einen Titel, der ganz oder gar nicht entstehen soll, `batch`.
|
||
- **Zeiten sind Sekunden**, nicht Frames, solange der Befehl nicht `frame` sagt.
|
||
- **Schrift:** `list_fonts`, dann `layer.setText`. Eine fehlende Familie nicht raten.
|
||
- **Ordner und Skripte.** Die Hilfe lehnt Skripte ab, sobald die Ordner-Flags gesetzt sind. Dann `execute_command` statt `run_script`.
|
||
|
||
## Rezept
|
||
|
||
**Titel, 1920×1080, 5 s, 30 fps:** `comp.new`, `layer.newText`, Deckkraft bei 0 s und 1 s per `add_keyframe` auf `transform/opacity`, `render_preview` bei 0 und bei 1, `save_project` unter neuem Namen. Eine MP4 nur, wenn der Nutzer eine Filmdatei will, und nur in den Schreib-Ordner.
|
||
|
||
## Abschlussprüfung
|
||
|
||
- `render_preview` zur genannten Zeit angesehen.
|
||
- `get_project`: Name, Größe, Dauer passen.
|
||
- Pfad der `.ecproj` genannt. Eine exportierte Filmdatei nur, wenn sie wirklich geschrieben wurde.
|
||
|
||
## Datenschutz
|
||
|
||
Ampel:
|
||
|
||
- Grün: allgemeine und technische Inhalte ohne Kundenbezug.
|
||
- Gelb: Projekt- und Geschäftsinfos, nur nach Abwägung oder anonymisiert.
|
||
- Rot: personenbezogene Daten und NDA-Inhalte gehören nicht in die Cloud-KI.
|
||
|
||
In Titeln Beispieltext statt echter Kundennamen.
|
||
|
||
## Grenzen
|
||
|
||
- Kein Schnittplatz. Clips aneinanderhängen ist FilmCraft.
|
||
- Encoder für h264, hevc, av1 und prores sind in der Hilfe genannt, auf dieser Maschine nicht durch einen Export geprüft.
|