Cavalry Motion App MCP Bridge

Ein Model Context Protocol (MCP)-Server, der KI-Assistenten (wie Claude Desktop, Antigravity, Cursor und ChatGPT) direkt mit Cavalry verbindet, der prozeduralen 2D-Bewegungsgrafik- und Animationsanwendung von Scene Group.

Funktionen

• Prozedurale Layer-Erstellung: Erstellen Sie Formen, Text, Duplikatoren, Gitter, Rauschgeneratoren, Farbpaletten, Mathematik-Knoten, Verformungen und Partikelemitter über natürliche Sprache.

• Dynamische Node-Graph-Verbindungen: Verbinden Sie Ausgänge und Eingänge zwischen Knoten (z. B. verbinden Sie einen Rauschgenerator mit der Skalierung oder Rotation einer Form).

• Attributsteuerung und Keyframing: Untersuchen und aktualisieren Sie jede Eigenschaft, bewegen Sie den Zeitstrahl und fügen Sie animierte Keyframes hinzu.

• Szenen-Introspection: Fragen Sie Metadaten der aktiven Komposition, Layer-Hierarchien und ausgewählte Knoten ab.

• Render-Pipeline: Fügen Sie Kompositionen zur Render-Warteschlange hinzu und lösen Sie Batch-Renderings aus.

• Rohe Skriptausführung: Führen Sie beliebiges JavaScript gegen das native api.*-Modul von Cavalry aus.

Architektur

┌─────────────────────────┐          stdio (MCP)         ┌─────────────────────────────────┐
│ AI Assistant / LLM      │ ◄──────────────────────────► │ Cavalry MCP Server              │
│ (Claude, Antigravity)   │                              │ (TypeScript / Node.js)          │
└─────────────────────────┘                              └────────────────┬────────────────┘
                                                                          │
                                                             HTTP POST    │ (http://127.0.0.1:8080)
                                                                          ▼
                                                         ┌─────────────────────────────────┐
                                                         │ In-Cavalry Script Bridge        │
                                                         │ (MCPBridge.js in Scripts menu)  │
                                                         │ ───► api.create(...)            │
                                                         │ ───► api.set(...)               │
                                                         │ ───► api.connect(...)           │
                                                         └─────────────────────────────────┘

Schnellstart

1. Abhängigkeiten installieren und erstellen

Führen Sie in diesem Projektverzeichnis aus:

npm install
npm run build

2. Bridge-Skript in Cavalry installieren

Führen Sie das Installationsprogramm aus, um MCPBridge.js in Ihren Cavalry-Skriptordner zu kopieren:

npm run install-bridge

Unter Windows wird MCPBridge.js nach %APPDATA%\Cavalry\Scripts\ kopiert.

3. Bridge in Cavalry starten

1. Starten Sie Cavalry.

2. Gehen Sie zum oberen Menü: Scripts → MCPBridge.

3. Ein kleines Panel öffnet sich mit der Anzeige Status: Online (Port 8080). Lassen Sie dieses geöffnet, während Sie den MCP-Server verwenden.

(Alternativ, wenn Sie bereits die Stallion-Erweiterung aktiv haben, hört diese ebenfalls auf Port 8080 und funktioniert nahtlos mit diesem MCP-Server).

4. Verbindung testen

Überprüfen Sie, ob der MCP-Server mit Cavalry kommunizieren kann:

npm run test-connection

MCP-Client-Konfiguration

Claude Desktop

Fügen Sie Folgendes zu Ihrer claude_desktop_config.json hinzu (befindet sich unter %APPDATA%\Claude\claude_desktop_config.json unter Windows oder ~/Library/Application Support/Claude/claude_desktop_config.json unter macOS):

{
  "mcpServers": {
    "cavalry": {
      "command": "node",
      "args": [
        "C:/Users/david/Documents/ANTIGRAVITY APP/CALVARY MCP/dist/index.js"
      ],
      "env": {
        "CAVALRY_BRIDGE_PORT": "8080"
      }
    }
  }
}

Antigravity / Cursor / Benutzerdefinierter Client

Fügen Sie zu Ihren Einstellungen oder .cursor/mcp.json hinzu:

{
  "mcpServers": {
    "cavalry": {
      "command": "node",
      "args": ["C:/Users/david/Documents/ANTIGRAVITY APP/CALVARY MCP/dist/index.js"]
    }
  }
}

Verfügbare MCP-Tools

Beispiel-Prompts für KI-Assistenten

1. Animiertes Rauschgitter

"Erstellen Sie ein 12x12-Gitter aus abgerundeten Quadraten in Cavalry, fügen Sie einen Rauschmodifikator an deren Rotation und Skalierung an und setzen Sie die Füllfarbe auf Elektroblau."

2. Kinetische Typografie

"Erstellen Sie kinetischen Text mit der Überschrift 'ANTIGRAVITY' in Cavalry. Setzen Sie die Schriftgröße auf 120, zentrieren Sie ihn und fügen Sie eine federnde Schwingung zur Y-Position hinzu."

3. Radialer Burst-Animation

"Erstellen Sie eine radiale Burst-Animation mit 24 Linien, die vom Zentrum nach außen strahlen, angetrieben von einem Schritt-Duplikator und mit Keyframes, um von Frame 0 bis Frame 45 zu expandieren."

Lizenz

MIT