Videokomprimierung automatisieren mit der CLI, dem MCP-Server und KI-Agenten

2. Juli 2026 • VideoRecompress Studio Team

Die meisten lernen VideoRecompress Studio über den Windows-Assistenten kennen: Videoordner hineinziehen, Preset wählen, Start klicken. Doch der Assistent ist nur eine Art, das Programm zu steuern. Dieselbe Komprimierungs-Engine — H.264, H.265, AV1, VP9, GPU-Hardware-Encoding — wird auch mit einer vollständigen Kommandozeile namens videorecompress, einem integrierten MCP-Server und einem installierbaren Claude-Code-Skill ausgeliefert.

Dieser Beitrag zeigt alle drei Ebenen: Skripten mit der videorecompress CLI, Anbinden des MCP-Servers an Claude Desktop oder Claude Code, und wie ein KI-Agent Ihre Komprimierungs-Pipeline auf Zuruf in natürlicher Sprache ausführt. Die vollständige CLI- und MCP-Referenz liegt im öffentlichen GitHub-Repository unter github.com/contentasoftware/videorecompress-studio-plugin

Drei Wege zur Automatisierung

• Kommandozeile

  Skripte, geplante Aufgaben und Stapelläufe.

• MCP-Server

  KI-Agenten rufen VideoRecompress als Werkzeug auf.

• Claude-Code-Skill

  Claude Code lernt die Befehle aus Ihrem Skills-Ordner.

Die videorecompress CLI: dieselbe Engine, skriptfähig

Die ausführbare Datei heißt videorecompress und wird zusammen mit der Desktop-App installiert — gleicher Installer, gleiche Lizenz. Eine Standardinstallation legt sie unter %LOCALAPPDATA%\Programs\VideoRecompressStudio\ ab und nimmt den Ordner in Ihren PATH auf, sodass videorecompress in jedem neuen Terminal funktioniert.

Sie bietet 9 Befehle: analyze, recompress, batch, presets, profile, watch, status, register und serve. Dateien analysieren, mit Codec und CRF neu komprimieren oder ganze Ordner stapelweise verarbeiten — alles in einer Zeile:

videorecompress info video.mp4 --json

videorecompress recompress video.mp4 --output ./compressed --preset phone_archive

videorecompress batch ./raw-footage --output ./archived --preset wedding_archive --workers 2

Jeder Befehl akzeptiert --json für maschinenlesbare Ausgabe (JSON oder NDJSON für Batch-Fortschritt) und liefert saubere Exit-Codes — die CLI fügt sich damit nahtlos in PowerShell-Skripte, Bash-Pipelines, CI-Jobs und geplante Aufgaben ein.

Zwei Preset-Optionen. --preset phone_archive wählt ein benanntes Preset (Codec, CRF und erwartete Ersparnis). --encoder-preset medium legt die Encoder-Geschwindigkeit fest (ultrafast bis veryslow). Verwenden Sie --preset für die benannten Presets und --encoder-preset nur zum Feinabstimmen der Encoder-Geschwindigkeit.

Automatisierungsrezepte aus der Praxis

1. Der geplante Archiv-Job

Richten Sie batch auf einen Ordner mit Rohmaterial und lassen Sie ihn über Nacht mit einem qualitätsorientierten Preset komprimieren. Ein Befehl macht aus einem Speicherkarten-Abzug eine archivierte Bibliothek:

videorecompress batch ./raw-footage --output ./archived --preset wedding_archive --workers 2

Planen Sie ihn wöchentlich in der Aufgabenplanung, und Ihre Kameraimporte werden automatisch komprimiert — Originaldateien unverändert, H.265-Archive bereit für die Langzeitaufbewahrung.

2. Der selbstlaufende Überwachungsordner

Der Befehl watch überwacht einen Ordner und komprimiert jedes neue Video automatisch. Einmal starten, und er läuft weiter — Dateien hinein, komprimierte Dateien heraus:

videorecompress watch C:\Videos --preset phone_archive --output C:\Compressed

Lassen Sie ihn per Aufgabenplanung bei der Anmeldung starten, und Sie haben einen Komprimierungsdienst ohne einen einzigen Klick: Handy-Videos, Bildschirmaufnahmen und Kameraimporte landen im Eingangsordner, und Sekunden später erscheinen kleinere H.265-Dateien im Ausgabeordner.

Der MCP-Server: die Engine in die Hand eines KI-Agenten

MCP (Model Context Protocol) ist der offene Standard, über den KI-Assistenten externe Werkzeuge aufrufen. VideoRecompress bringt einen integrierten MCP-Server mit — gestartet mit einem einzigen Befehl:

// claude_desktop_config.json
{
  "mcpServers": {
    "videorecompress": {
      "command": "videorecompress",
      "args": ["serve"]
    }
  }
}

Er stellt 5 Tools bereit — Video analysieren, Datei neu komprimieren, Stapelverarbeitung, Presets auflisten und Speicherersparnis schätzen — und funktioniert schon in der kostenlosen Testphase. Für Claude Desktop tragen Sie dies in Ihre claude_desktop_config.json ein:

Von da an können Sie Ihren Assistenten bitten: „Komprimiere jede MP4-Datei in meinem Downloads-Ordner mit dem Preset phone_archive neu“ — und er ruft die lokale Engine direkt auf. Ihre Videos verlassen nie Ihren Rechner: Der Agent orchestriert, die Komprimierung läuft lokal.

Claude-Code-Skill: Videokomprimierung in natürlicher Sprache

Wenn Sie Claude Code verwenden: Der Skill /contenta-video ist zusammen mit dem MCP-Server im VideoRecompress Studio-Plugin enthalten, eine Installation gibt dem Agenten also beides. Zwei Befehle:

/plugin marketplace add contentasoftware/videorecompress-studio-plugin
/plugin install videorecompress-studio@videorecompress-studio-plugin

In Cursor, Claude Desktop, VS Code oder jedem anderen MCP-Client fügen Sie diesen Server-Eintrag hinzu (benötigt Node.js 18 oder neuer):

{
  "mcpServers": {
    "videorecompress-studio": { "command": "cmd", "args": ["/c", "npx", "-y", "@contentasoft/videorecompress-mcp"] }
  }
}

Danach beschreiben Sie die Aufgabe einfach in eigenen Worten — „komprimiere diesen Hochzeitsordner stapelweise mit maximaler Qualität“ oder „überwache meinen Bildschirmaufnahme-Ordner und komprimiere neue Dateien“. Der Skill übersetzt die Anfrage in die richtigen videorecompress-Befehle und meldet das Ergebnis.

Alles dokumentiert auf GitHub

Der Plugin-Quellcode, die MCP-Server-Referenz und die CLI-Dokumentation liegen im öffentlichen GitHub-Repository, das Launcher-Paket ist auf npm veröffentlicht: github.com/contentasoftware/videorecompress-studio-plugin · npmjs.com/package/@contentasoft/videorecompress-mcp

Die Doku wird zusammen mit dem Produkt gepflegt — was Sie dort lesen, entspricht der Binärdatei auf Ihrer Platte. Kopieren Sie die Rezepte direkt in Ihre eigenen Skripte oder eröffnen Sie ein Issue, wenn Sie auf einen Grenzfall stoßen.

Häufige Fragen