Blender Animation MCP

Un servidor MCP especializado en animación para Blender. Combina herramientas precisas de línea de tiempo y fotogramas clave con retroalimentación visual renderizada, de modo que un modelo multimodal pueda inspeccionar lo que animó en lugar de razonar únicamente a partir de las transformaciones.

import_glb_asset carga activos GLB/glTF con texturas o con rig sin aplanar su jerarquía; inspect_rig expone esqueletos y ligaduras; y key_pose_bone ofrece una interfaz de pose más segura que las rutas RNA directas. Los clips de animación incrustados existentes son importados por el importador glTF de Blender y se incluyen en la revisión visual.

Lo que puede ver y controlar

• Renderiza cualquier fotograma exacto y lo devuelve como contenido de imagen MCP.

• Renderiza una hoja de contacto muestreada a lo largo de la toma para una revisión visual rápida.

• Muestrea las transformaciones globales evaluadas y las cajas delimitadoras a lo largo del tiempo.

• Inspecciona acciones, curvas F, controles, interpolación, tiras de NLA, restricciones, cámaras y marcadores.

• Inserta o elimina fotogramas clave, cambia la interpolación, controla la línea de tiempo y guarda el archivo.

• Importa activos .glb y .gltf con su jerarquía, materiales, rigs y clips de animación.

• Inspecciona esqueletos generados y huesos clave directamente con cuaterniones en espacio local.

• Descubre posibles cadenas de extremidades con peso e inspecciona sus ejes locales reales.

• Comprueba la deformación de huesos de forma no destructiva antes de crear poses.

• Crea controles IK de patas, insértalos en espacio global y valida el deslizamiento del pie apoyado.

La hoja de contacto se elabora con renderizados reales de la escena. Está limitada deliberadamente a 25 fotogramas; para una revisión detallada, llama a render_frame sobre los fotogramas sospechosos. La animación es temporal, así que ninguna muestra finita demuestra que todos los fotogramas intermedios sean correctos: el flujo de trabajo previsto es una hoja de contacto, fotogramas seleccionados, evaluación numérica y, después, otra pasada visual.

Related MCP server: Blender MCP

Instalación

1. Comprime el directorio blender_addon (el zip debe contener blender_addon/__init__.py) e instálalo desde Editar > Preferencias > Complementos > Instalar desde disco. Habilita Animation MCP Bridge.

2. El puente se inicia automáticamente con Blender. Usa Propiedades de la escena > Animation MCP para ver su estado o detenerlo o reiniciarlo.

3. Instala este paquete MCP:

   pip install -e .

4. Agrégalo a la configuración de tu cliente MCP:

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

Por razones de seguridad, el puente se une a localhost por defecto. Si configuras un token en Blender, define el mismo BLENDER_MCP_TOKEN para el proceso MCP. No expongas el puerto a una red no segura.

Bucle de modelo recomendado

1. Ejecuta inspect_scene e inspect_object_animation antes de editar. Para un asset GLB/glTF nuevo, llama primero a import_glb_asset y a inspect_rig si tiene rig.

2. Establece fotogramas clave e interpolación.

3. Ejecuta inspect_animation_visual en toda la toma.

Para la vinculación de poses guiada por vídeo, llama a setup_video_reference con el MP4 de origen; luego usa render_video_overlay para poses clave exactas o inspect_video_overlay para una hoja de contacto. Ajusta video_frame_offset para alinear la línea de tiempo de Blender con el intervalo útil de la referencia antes de animar el rig. Para rigs generados desconocidos, ejecuta discover_limb_chains, inspecciona los candidatos con inspect_bone_axes y confirma la articulación de bisagra con probe_bone_deformation. Solo entonces crea controles IK de patas con create_limb_ik; anímalos con key_paw_pose y revisa los contactos con advanced_walk_cycle. 4. Usa render_frame en contactos, extremos y discontinuidades visibles. 5. Usa evaluate_animation cuando sean clave el espaciado exacto o las transformaciones globales. 6. Itera, luego save_blend.

Variables de entorno

BLENDER_MCP_HOST, BLENDER_MCP_PORT, BLENDER_MCP_TOKEN y BLENDER_MCP_TIMEOUT configuran la conexión entre MCP y Blender.

Para ejecutar Blender sin ventana, después de habilitar el complemento:

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

El servicio incluido systemd/blender-animation-mcp.service ejecuta este worker de forma persistente en el puerto 9877.