Mixamo Retarget (via Blender MCP)

Retargets skeletal animations between armatures inside Blender, driven entirely through the already-connected Blender MCP. The engine is the retargeting module extracted from Dev-GOM's blender-toolkit (Apache-2.0; attribution below) — the valuable 700 lines, without the plugin's WebSocket server, CLI build, hooks, or second Blender addon.

Status: EXPERIMENTAL — extracted and syntax-checked, not yet fixture-validated. Before first production use, run the fixture at the bottom and record the result.

What it does

• auto_map_bones(source, target) — fuzzy bone matching with a Mixamo alias table (works on mixamorig:-prefixed and bare names).
• get_preset_bone_mapping("mixamo_to_rigify") — known-good preset.
• store_bone_mapping / load_bone_mapping — persist a reviewed map per armature pair (scene-level), so the fuzzy pass runs once and the corrected map is reused.
• retarget_animation(source, target, bone_map, action_name) — bakes the retargeted action onto the target rig.
• import_fbx / import_dae, list_armatures, get_bones, list_animations, play_animation, add_to_nla.

How to run it (through the Blender MCP)

The two modules in scripts/ are plain Blender-Python. Load them once per session by exec-ing them in Blender's interpreter, in dependency order: