Blender Animation MCP

Специализированный на анимации MCP-сервер для Blender. Он объединяет точечные инструменты работы с таймлайном и ключевыми кадрами с отрисованной визуальной обратной связью, чтобы мультимодальная модель могла проверять то, что она анимировала, а не рассуждать об этом только по трансформациям.

import_glb_asset загружает текстурированные или снабжённые ригом ресурсы GLB/glTF, не уплощая их иерархию; inspect_rig показывает скелеты и привязки; а key_pose_bone даёт более безопасный интерфейс для поз, чем сырые RNA-пути. Существующие встроенные анимационные клипы импортируются glTF-импортёром Blender и включаются в визуальный просмотр.

Что он видит и чем управляет

• Рендерит точно указанный кадр и возвращает его как MCP-изображение.

• Рендерит контактный лист — выборку кадров по всему шоту — для быстрой визуальной проверки.

• Сэмплирует вычисленные мировые трансформации и ограничивающие объёмы по времени.

• Просматривает экшены, F-кривые, хэндлы, интерполяцию, NLA-полосы, констрейнты, камеры и маркеры.

• Вставляет и удаляет ключи, изменяет интерполяцию, управляет таймлайном и сохраняет файл.

• Импортирует произвольные .glb и .gltf-ресурсы с их иерархией, материалами, ригами и анимационными клипами.

• Просматривает сгенерированные скелеты и ключевые кости напрямую, через кватернионы в локальном пространстве.

• Находит кандидатов в весовые цепочки конечностей и проверяет их фактические локальные оси.

• Проверяет деформацию костّй без внесения изменений перед созданием поз.

• Создаёт IK-контроллеры лап, анимирует их в мировом пространстве и проверяет проскальзывание опорной стопы.

Контактный лист создаётся из реального рендера сцены. Он намеренно ограничен 25 кадрами; для детального просмотра вызывайте render_frame на подозрительных кадрах. Анимация существует во времени, поэтому конечная выборка не доказывает корректность всех промежуточных кадров — предусмотренный процесс следующий: контактный лист, точечные кадры, численная оценка, затем ещё один визуальный проход.

Related MCP server: Blender MCP

Установка

1. Заархивируйте каталог blender_addon (в zip должен обязательно содержаться blender_addon/__init__.py) и установите его через Edit > Preferences > Add-ons > Install from Disk. Включите аддон Animation MCP Bridge.

2. Мост запускается автоматически вместе с Blender. Используйте Scene Properties > Animation MCP, чтобы увидеть его статус или остановить/перезапустить его.

3. Установите этот MCP-пакет:

   pip install -e .

4. Добавьте его в конфигурацию вашего MCP-клиента:

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

Для безопасности мост по умолчанию привязывается к localhost. Если вы настроили токен в Blender, задайте тот же BLENDER_MCP_TOKEN для MCP-процесса. Не открывайте порт на недоверенную сеть.

Рекомендуемый цик модели

1. Выполните inspect_scene и inspect_object_animation до реального редактирования. Для нового раснод .gltf assets то for ноno on: Для нового GLB/glTF asset выполните в первый очередь import_glb_asset а затем inspect_rig, если он ригован.

2. Проставьте ключи и интерполяцию.

3. inspect_animation_visual по всей длине шота.

Для сравнения поз с видео вызывайте setup_video_reference с исходным MP4, затем используйте render_video_overlay для точных опорных поз или inspect_video_overlay для контактного листа. Подгоните video_frame_offset так, чтобы таймлайн Blender совпадал с полезным интервалом референса перед тем, как вы начнете ставить ключи на сетку.

Для незнакомых сгенерированных ригов запустите discover_limb_chains, проанализируйте кандидатов с помощью inspect_bone_axes и подтвердите шарнирное поведение через probe_bone_deformation. Только потом создавайте ИК-контроллеры лап с create_limb_ik, анимируйте их с помощью center_paw_pose и проверяйте контакт с полом в validate_walk_cycle. 4. Вызывайте render_frame вокруг моментов контакта, экстремумов и видимых разрывов. 5. Используйте evaluate_animation, когда важны точные промежутки или мировые трансформации. 6. Итерируйте, затем сохраните через save_blend.

Переменные окружения

BLENDER_MCP_HOST, BLENDER_MCP_PORT, BLENDER_MCP_TOKEN and BLENDER_MCP_TIMEOUT настраивают соединение между MCP и Blender.

Чтобы запускать Blender без окна, после чтобы включении адlonа:

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

Входящий в комплект systemd/blender-animation-mcp.service запускает этот воркер постоянно на пору 9877.