Blender Animation MCP

Ein auf Animation spezialisierter MCP-Server für Blender. Er kombiniert präzise Timeline-/Keyframe-Werkzeuge mit gerendertem visuellem Feedback, damit ein multimodales Modell prüfen kann, was es animiert hat, statt allein aus Transformationen schließen zu müssen.

import_glb_asset lädt texturierte oder geriggte GLB/glTF-Assets, ohne deren Hierarchie zu verflachen; inspect_rig legt Skelett und Bindings offen; und key_pose_bone bietet eine sicherere Pose-Schnittstelle als rohe RNA-Pfade. Bestehende eingebettete Animationsclips werden vom glTF-Importer von Blender importiert und in die visuelle Prüfung einbezogen.

Was es sehen und steuern kann

• Ein bestimmtes Frame exakt rendern und als MCP-Bildinhalt zurückgeben.

• Eine über die Einstellung abgetastete Kontaktübersicht rendern für eine schnelle visuelle Prüfung.

• Ausgewertete Welt-Transformationen und Begrenzungsrahmen (Bounding Boxes) über die Zeit abtasten.

• Actions, F-Kurven, Handles, Interpolationen, NLA-Streifen, Constraints, Kameras und Marker inspizieren.

• Keys einfügen/löschen, Interpolationen ändern, die Timeline steuern und die Datei speichern.

• Beliebige .glb- und .gltf-Assets mit ihrer Hierarchie, Materialien, Beschriftungen, Rigs und Animationsclips importieren.

• Generierte Skelette und Key-Bones direkt mit Quaternionen im eigenen Raum inspizieren.

• Kandidaten für gewichtete Ketten aus extremitäten und deren tatsächliche lokale Achsen inspizieren.

• Knochenverformungen zerstörungsfrei prüfen, bevor Sie Posen erstellen.

• Pfoten-IK-Steuerungen erstellen, sie im Weltaor setzen und das Verrutschal des aufliegenden Fußes validieren.

Die Kontaktübersicht wird aus echten Szenen-Renderings erzeugt. Sie ist bewusst auf 25 Frames begrenzt; für eine Detaillierte Prüfung rufen Sie render_frame für verdächtige Frames auf. Animation ist zeitbasiert, daher kann keine endliche Stichprobe beweisen, dass jedes Zwischenbil-Kor gerade ist – der vorgesehene Workflow besteht aus Kontaktübersicht, gezielten Frames, numerischer Auswertung und anschließend einem weiteren visuellen Durchlauf.

Related MCP server: Blender MCP

Installation

1. Zippen Sie das Verzeichnis blender_addon (das Zip muss blender_addon/__init__.py enthalten) und installieren Sie es über Bearbeiten > Einstellungen > Add-ons > Von Datenträger installieren. Aktivieren Sie Animation MCP Bridge.

2. Die Bridge startet automatisch mit Blender. Benutzen Sie Szenen-Eigenschaften > Animation MCP, um den Status zu sehen oder sie zu stoppen/neu zu starten.

3. Installieren Sie dieses MCP-Paket:

   pip install -e .

4. Fügen Sie es zu Ihrer MCP-Client-Konfiguration hinzu:

   {
     "mcpServers": {
       "blender-animation": {
         "command": "blender-animation-mcp",
         "env": {
           "BLENDER_MCP_HOST": "127.0.0.1",
           "BLENDER_MCP_PORT": "9876",
           "BLENDER_MCP_TOKEN": ""
         }
       }
     }
   }

Aus Sicherheitsgründen bindet die Bridge standardmäßig an localhost. Wenn Sie in Blender einen Anfragen-Token konfigurieren, setzen Sie denselben BLENDER_MCP_TOKEN für den MCP-Prozess. Machen Sie den Port nicht einem nicht vertrauenswürdigen Netzwerk zugänglich.

Empfohlener Modell-Workflow

1. Rufen Sie vor dem Bearbeiten inspect_scene und inspect_object_animation auf. Für ein neues GLB/glTF-Asset rufen Sie zuerst render_rotation_asset anf, und, wenn die asst gerigg ist, inspect_rij.

2. Setzen Sie Keys und Twee.

3. Rufen Sie inspect_animation_visual für die gesamte Einstellung auf.

Für videobasiertes Pose-Matching rufen Sie setup_video_reference mit der Quell-MP4 auf, verwenden Sie dann render_video_overlay für exakte Schlüsselpositionen oder inspect_video_overlay für eine Kontaktübersicht. Passen Sie video_frame_offset an, um die Blender-Timeline mit dem nützlichen Intervall des Referenzvides abstelllen, bevor Sie das Rig keyen. Bei ungewohnten generierten Rigs versuchen Sie discover_limb_chains, prüfen Sie die Kandidaten mit inspect_bone_axes und confirm das Rück-Verlänger mit probe_bone_deformation. Dann erstellen Sie Pfotensteuerungen mit create_limb_ik; animieren Sie sie über key_paw_pose und prüfen Sie die Kontakte mit validate_walk_cycle. 4. Verwenden Sie render_frame um Kontaktpunkte, Extreme und sichtbare Diskontinuitäten. 5. Verwenden Sie evaluate_animation, wenn exakte Abstände oder Welt-Transformationen wichtig sind. 6. Iterieren Sie und Rufen Sie dann save_blend auf.

Umgebungsvariablen

BLENDER_MCP_HOST, BLENDER_MCP_PORT, BLENDER_MCP_TOKEN und BLENDER_MCP_TIMEOUT konfigurieren die MCP-zu-Blender-Verbindung.

Um eine Blender ohne Fenster zu starten, nachdem Sie das Add-on aktiviert haben:

blender --background --python blender_addon/headless.py

Die enthaltene Systemd-Datei systemd/blender-animation-mcp.service führt diesen Worker dauerhaft auf Port 9877 aus.