@velxor/mcp

Ein MCP-Server (Model Context Protocol), der Claude Code, Cursor und andere MCP-fähige Agenten in die Lage versetzt, alle drei Vlexor-Säulen – KI-Videobearbeitung, Game-Asset-Generierung und Motion-Graphics-Produktion – direkt aus einer Coding-Session heraus anzusteuern.

Die Videobearbeitung läuft auf Ihrem eigenen Material: Ihr Rohvideo verlässt niemals Ihren Rechner – nur der Text Ihrer Anweisungen (und ein optionales Transkript) wird an Vlexor gesendet, um den Bearbeitungsplan zu erstellen, der dann in einen echten FFmpeg-Befehl kompiliert und vollständig lokal gerendert wird. Asset-Generierung und Motion Graphics werden serverseitig gerendert (es gibt kein zu schützendes lokales Material) und geben eine signierte Download-URL zurück – optional direkt an einen lokalen Pfad gespeichert.

Setup

1. Generieren Sie einen persönlichen API-Schlüssel unter Vlexor → Einstellungen → MCP & API.

2. Installieren Sie FFmpeg, falls Sie es noch nicht haben (brew install ffmpeg auf macOS, oder setzen Sie VLEXOR_FFMPEG_DIR auf einen Ordner, der ffmpeg/ffprobe enthält).

3. Fügen Sie dies zur Konfiguration Ihres MCP-Clients hinzu:

{
  "mcpServers": {
    "vlexor": {
      "command": "npx",
      "args": ["-y", "@velxor/mcp"],
      "env": { "VLEXOR_API_KEY": "vlx_…" }
    }
  }
}

Related MCP server: CutPilot

Tools

Säule 1 – Videobearbeitung (wird lokal gerendert; Material wird nie hochgeladen):

• probe_media – Dauer, Auflösung, fps, Codec eines lokalen Videos auslesen.

• generate_edit_plan – natürlichsprachliche Anweisung → strukturierter Bearbeitungsplan (ruft die echte Vlexor Command Engine auf; zählt gegen Ihr Kontingent).

• compile_edit_plan – Bearbeitungsplan → ein echter FFmpeg-Befehl, vollständig lokal berechnet.

• render – den kompilierten Befehl lokal ausführen, um das endgültige Video zu erzeugen.

Ein typischer Agentenablauf: probe_media → generate_edit_plan → (Schritte prüfen) → compile_edit_plan → (FFmpeg-Befehl prüfen) → render.

Säule 2 – Asset-Generierung (wird serverseitig gerendert):

• generate_game_asset – Prompt → eine Textur, 2D-Figur, Sprite-Sheet, 3D-Modell (.glb), Soundeffekt, Musikspur, Parallax-Hintergrund oder Figurendrehung. Gibt eine signierte Download-URL zurück; übergeben Sie savePath, um die Datei auch lokal zu speichern.

Säule 3 – Motion Graphics (wird serverseitig gerendert):

• generate_motion_graphic – eine kurze kreative Beschreibung → ein gerendertes Kinetic-Title-.mp4 (Ankündigungs-/Werbebanner). Gibt eine signierte Download-URL zurück; übergeben Sie savePath, um die Datei auch lokal zu speichern.

Umgebungsvariablen

Über dieses Repository

Dieses Paket ist die dünne Integrationsschicht, die einen MCP-Client mit der echten, gehosteten API von Vlexor verbindet – jeder Tool-Aufruf hier ist eine einfache, überprüfbare HTTP-Anfrage (Sie können genau nachlesen, was Ihren Rechner verlässt, in src/api-client.ts). Es ist offen, damit Agententwickler, die ihren API-Schlüssel darüber leiten, das selbst überprüfen können.

Die Vlexor-Plattform selbst – die Bearbeitungs-Engine, das KI-Prompt-Design, die Asset-/Motion-Graphics-Erzeugungspipelines – ist Closed-Source. Einige Importe dieses Pakets (@velxor/engines FFmpeg-Plan-Compiler, @velxor/shared's Typdefinitionen) stammen aus dieser privaten Codebasis und werden nicht separat veröffentlicht, daher kann dieses Repo nicht mit pnpm install/build standalone ausgeführt werden – es ist zum Lesen gedacht und wird über das vorgefertigte npm-Paket (npx -y @velxor/mcp) ausgeführt, nicht aus diesem Checkout kompiliert.

Issues und PRs zur MCP-Integrationsschicht selbst (Tool-Schemas, Fehlerbehandlung, die lokale FFmpeg-Orchestrierung) sind willkommen.

License

MIT