Skip to main content
Glama
deenesjakoruzh
tattooinmtl

Blender MCP

by tattooinmtl
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

Blender MCP — MiniMax Connector for Blender 5.2 LTS

Мост Model Context Protocol, который позволяет MiniMax Code (и любому MCP-клиенту) управлять Blender 5.2 LTS через естественный язык. Поставляется в виде двух артефактов:

Артефакт

Что это

Где находится

Аддон Blender

Python-аддон, запускающий MCP Streamable-HTTP сервер внутри Blender в фоновом потоке

addon/blender_mcp_addon/ → устанавливается в Blender

MiniMax Plugin V1

Локальный плагин MiniMax Code, который подключается к запущенному серверу Blender MCP и предоставляет его инструменты агенту

connector/ → устанавливается в C:/Users/.../.minimax/plugins/blender-mcp/

Аддон Blender — источник истины для состояния на стороне Blender. Плагин MiniMax — тонкий клиент, который вызывает HTTP-эндпоинт аддона. На стороне MiniMax не запускается ни один Python-процесс, поэтому нет ни утечки портов, ни проблем с жизненным циклом.

Почему такая архитектура

  • Единый путь установки внутри Blender — MCP-сервер работает в том же процессе, используя bpy, так что операция uvx/pipx не нужна, и не нужно синхронизировать пару сокетов.

  • Streamable-HTTP на localhost — работает с любым современным MCP-клиентом (MiniMax Code, Claude Desktop, Cursor) и переживает перезапуски Blender.

  • Самописный MCP-сервер в аддоне — Blender 5.2 LTS поставляет Python 3.13 без внешних пакетов по умолчанию. MCP-сервер на ~300 строк более переносим, чем подключение mcp[cli] и правка sys.path.

  • MiniMax Plugin V1 с capability streamable-http — плагин ничего порождает; он просто указывает на эндпоинт аддона Blender.

Related MCP server: blender-mcp-ultra

Структура проекта

blender_addon_mcp/
├── README.md                      ← you are here
├── LICENSE                        ← MIT
├── pyproject.toml                 ← dev tooling for the add-on (ruff, mypy, pytest)
├── .gitignore
├── addon/
│   └── blender_mcp_addon/         ← zips into a Blender-installable .zip
│       ├── __init__.py            ← bl_info, register/unregister
│       ├── preferences.py         ← AddOnPreferences (port, auth token, autostart)
│       ├── server/
│       │   ├── __init__.py
│       │   ├── mcp_server.py      ← MCP protocol (initialize, tools/list, tools/call, ping)
│       │   ├── transport.py       ← stdlib http.server, runs on a daemon thread
│       │   └── protocol.py        ← JSON-RPC 2.0 + MCP 2025-03-26 types
│       ├── tools/
│       │   ├── __init__.py        ← tool registry
│       │   ├── scene.py           ← scene_info, frame control
│       │   ├── objects.py         ← list, get, create, delete, transform
│       │   ├── materials.py       ← create, assign, modify
│       │   ├── modifiers.py       ← add, set params, remove
│       │   ├── render.py          ← render_image, screenshot_viewport
│       │   └── code.py            ← execute_python (with confirmation)
│       └── utils/
│           ├── __init__.py
│           ├── bpy_helpers.py     ← bpy → JSON serialization
│           └── safe_eval.py       ← ast-validated code execution
├── connector/                     ← MiniMax Plugin V1 source
│   ├── .minimax-plugin/
│   │   └── plugin.json
│   ├── servers/
│   │   └── blender.mcp.json       ← streamable-http → http://127.0.0.1:8765/mcp
│   ├── icon.png                   ← category icon (Design / 3D)
│   └── README.md
├── scripts/
│   ├── install_addon.ps1          ← zip and install into Blender
│   └── install_connector.ps1      ← copy connector into ~/.minimax/plugins/
├── examples/
│   ├── basic_scene.md
│   ├── material_setup.md
│   └── render_workflow.md
└── docs/
    ├── architecture.md
    ├── blender_5_2_notes.md
    └── tools_reference.md

Быстрый старт

# 1. Clone the repository
git clone https://github.com/tattooinmtl/Minimax_Blender_MCP.git
cd Minimax_Blender_MCP

# 2. Install the Blender add-on
pwsh ./scripts/install_addon.ps1

# 3. Install the MiniMax connector plugin
pwsh ./scripts/install_connector.ps1

4. Включение в Blender

  1. Откройте Blender.

  2. Перейдите в Edit → Preferences → Add-ons.

  3. Найдите переключатель «Blender MCP» и установите флажок, чтобы включить его.

  4. Укажите порт (по умолчанию 8765) и нажмите Start Server (либо запустите его с боковой панели 3D Viewport на вкладке Blender MCP).

  5. Вы увидите [Blender MCP] Server listening on http://127.0.0.1:8765/mcp в консоли.

3. Проверка

В чате MiniMax Code задайте вопрос:

Используйте коннектор Blender: перечислите первые 5 объектов в текущей сцене.

Вы должны увидеть, как агент вызывает tools/list на вашем запущенном Blender.

Доступные инструменты

Инструмент

Назначение

Только чтение

get_addon_info

Рукопожатие возможностей — имя, версия, протокол, список инструментов. Вызовите это первым.

да

scene_info

Сводка по сцене (объекты, света, камеры, кадр)

да

list_objects

Список объектов сцены, опциональная фильтрация по типу

да

get_object

Полные сведения об объекте (положение, поворот, масштаб, модификаторы, материалы)

да

create_object

Создать примитив (cube, sphere, plane, cylinder, cone, torus, empty, camera, light)

нет

delete_object

Удалить объект по имени

нет

transform_object

Задать положение/поворот/масштаб

нет

set_material

Создать или назначить материал с Principled BSDF

нет

set_texture

Применить файл изображения к входу материала (base_color, roughness, normal и т.д.)

нет

import_asset

Импорт GLB/GLTF/FBX/OBJ/STL/PLY/DAE/USD/X3D/ABC

нет

add_modifier

Добавить модификатор (subdivision, mirror, solidify, array, bevel)

нет

remove_modifier

Удалить модификатор по имени

нет

frame_get / frame_set

Чтение / перемещение по таймлайну

смешанный

render_image

Рендер текущего кадра в файл

нет

screenshot_viewport

Сделать скриншот текущего вьюпорта

нет

execute_python

Выполнить произвольный код bpy (защищён с помощью ast-проверки)

нет

ping

Проверка связи

да

Плагин MiniMax также поставляет Skill (blender-mcp-quickstart), который даёт агенту краткий обзор инструментов, правила безопасности и типовые рецепты. Прочитайте его перед нетривиальной работой.

Полную схему и примеры см. в docs/tools_reference.md.

Разработка

# syntax-check the add-on (Blender's Python is at <blender>/python/bin/python.exe)
python -m py_compile addon/blender_mcp_addon/__init__.py
python -m py_compile addon/blender_mcp_addon/server/mcp_server.py
# ...etc

# lint
ruff check addon/
mypy addon/

# test the MCP server in isolation (no bpy required)
pytest addon/tests/ -v

Лицензия

MIT. См. LICENSE.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Blender MCP VXAI

    VxASI
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables natural language control of Blender 3D through MCP clients, allowing creation, modification, and manipulation of 3D models, animations, and scenes.
    300
    MIT

  • Blender MCP

    tattooinmtl
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables any MCP client to drive Blender 5.2 LTS through natural language, with tools for scene inspection, object creation and transformation, material and modifier handling, rendering, viewport capture, and guarded Python execution.
    1
    MIT

  • Blender MCP

    tattooinmtl
    A
    license
    Not graded
    quality
    B
    maintenance
    Enables any MCP client to control Blender 5.2 LTS via natural language, including scene creation, object manipulation, material assignment, rendering, and Python execution.
    1
    MIT