Мост Model Context Protocol, который позволяет MiniMax Code (и любому MCP-клиенту) управлять Blender 5.2 LTS через естественный язык. Поставляется в виде двух артефактов:
Артефакт | Что это | Где находится |
Аддон Blender | Python-аддон, запускающий MCP Streamable-HTTP сервер внутри Blender в фоновом потоке |
|
MiniMax Plugin V1 | Локальный плагин MiniMax Code, который подключается к запущенному серверу 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: BlenderMCP
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Откройте Blender.
Перейдите в Edit → Preferences → Add-ons.
Найдите переключатель «Blender MCP» и установите флажок, чтобы включить его.
Укажите порт (по умолчанию 8765) и нажмите Start Server (либо запустите его с боковой панели 3D Viewport на вкладке Blender MCP).
Вы увидите [Blender MCP] Server listening on http://127.0.0.1:8765/mcp в консоли.
В чате MiniMax Code задайте вопрос:
Используйте коннектор Blender: перечислите первые 5 объектов в текущей сцене.
Вы должны увидеть, как агент вызывает tools/list на вашем запущенном Blender.
Инструмент | Назначение | Только чтение |
| Рукопожатие возможностей — имя, версия, протокол, список инструментов. Вызовите это первым. | да |
| Сводка по сцене (объекты, света, камеры, кадр) | да |
| Список объектов сцены, опциональная фильтрация по типу | да |
| Полные сведения об объекте (положение, поворот, масштаб, модификаторы, материалы) | да |
| Создать примитив (cube, sphere, plane, cylinder, cone, torus, empty, camera, light) | нет |
| Удалить объект по имени | нет |
| Задать положение/поворот/масштаб | нет |
| Создать или назначить материал с Principled BSDF | нет |
| Применить файл изображения к входу материала (base_color, roughness, normal и т.д.) | нет |
| Импорт GLB/GLTF/FBX/OBJ/STL/PLY/DAE/USD/X3D/ABC | нет |
| Добавить модификатор (subdivision, mirror, solidify, array, bevel) | нет |
| Удалить модификатор по имени | нет |
| Чтение / перемещение по таймлайну | смешанный |
| Рендер текущего кадра в файл | нет |
| Сделать скриншот текущего вьюпорта | нет |
| Выполнить произвольный код | нет |
| Проверка связи | да |
Плагин 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/ -vMIT. См. LICENSE.
This server cannot be installed
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
MCP server for AI dialogue using various LLM models via AceDataCloud
MCP server for Producer/Riffusion AI music generation
MCP server for Hailuo (MiniMax) AI video generation
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/tattooinmtl/Minimax_Blender_MCP'
If you have feedback or need assistance with the MCP directory API, please join our Discord server