
bpy-dev/blender-mcp
Developer toolsЭта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал
Независимое расширенное распространение Blender Lab MCP: автономный bpy, документация по API во время выполнения и инструменты для бенчмарков
Обзор
Эта ветка предоставляет улучшенный рабочий процесс Blender MCP для работы с агентами Blender. Он сохраняет модель дополнения/сервера Blender в режиме upstream и добавляет выполнение с сохраненным файлом/headless, выбираемые командные бэкенды, поиск API Blender Python во время выполнения, усиление подпроцессов/захвата и инструменты для тестирования. Это модифицированный дистрибутив проекта Blender MCP от Blender Lab. См. NOTICE.md для происхождения и SECURITY.md для модели риска исполнения. Активы публичного bpy.dev сайта будут храниться в отдельном репозитории. Сборник охватывает . Его на видео маркировка «CLIP accuracy» означает . Связанное неизменяемое видео H.264 составляет 848×464, 134,9 секунды и 10 161 884 байта; SHA-256: 04966320de680203baed6c01c3e211059350454139dc8a802c557cce24815c17. - _for_cli инструменты работают с .blend-файлами в свежих подпроцессах без необходимости живой сессии интерфейса Blender. - использовать исполняемый бэкенд Blender или отдельный bpy Python бэкенд с BLENDER_MCP_CLI_BACKEND.
Обзор (машинный перевод)
Улучшенный превью разработчиков MCP
Эта ветка предоставляет улучшенный рабочий процесс Blender MCP для работы с агентами Blender. Он сохраняет модель дополнения/сервера Blender в режиме upstream и добавляет выполнение с сохраненным файлом/headless, выбираемые командные бэкенды, поиск API Blender Python во время выполнения, усиление подпроцессов/захвата и инструменты для тестирования.
Это модифицированный дистрибутив проекта Blender MCP от Blender Lab. См. NOTICE.md для провенанса и SECURITY.md модели риска исполнения. Публичные активы веб-сайта bpy.dev будут храниться в отдельном репозитории.
Результат BlenderBench
Сборник охватывает 27 заданий / 270 раундов. Его видео с надписью «CLIP accuracy» означает
КЛИП — сходство косинуса, вложение изображения, а не буквальную точность. Связанная неизменная
Видео H.264 — 848×464, 134,9 секунды и 10 161 884 байта; SHA-256:
04966320de680203baed6c01c3e211059350454139dc8a802c557cce24815c17.
Что усиливается
- Инструменты сохраненных файлов:
_for_cliинструменты работают с.blendфайлами в свежих подпроцессах без необходимости живой сессии интерфейса Blender. - Выбор бэкенда: используйте исполняемый бэкенд Blender или отдельный
bpyбэкенд Python сBLENDER_MCP_CLI_BACKEND.
Эта страница переведена автоматически. Технические детали смотрите в оригинале.
README
Показан фрагмент оригинального README. Открыть оригинал.
Blender MCP
Enhanced MCP developer preview
This branch packages an enhanced Blender MCP workflow for agentic Blender work. It keeps the upstream live Blender add-on/server model and adds saved-file/headless execution, selectable command-line backends, runtime Blender Python API lookup, subprocess/capture hardening, and benchmark tooling.
This is a modified distribution of Blender Lab’s Blender MCP project. See NOTICE.md for provenance and SECURITY.md for the execution-risk model. Public bpy.dev website assets will live in a separate repository.
BlenderBench result
The compilation covers 27 tasks / 270 rounds. Its on-video “CLIP accuracy” label means
CLIP image-embedding cosine similarity, not literal accuracy. The linked immutable
H.264 video is 848×464, 134.9 seconds, and 10,161,884 bytes; SHA-256:
04966320de680203baed6c01c3e211059350454139dc8a802c557cce24815c17.
What is enhanced
- Saved-file tools:
_for_clitools operate on.blendfiles in fresh subprocesses without requiring a live Blender UI session. - Backend selection: use a Blender executable backend or a standalone
bpyPython backend withBLENDER_MCP_CLI_BACKEND. - Runtime API lookup: agents can query exact signatures, enums, defaults, and availability from the active Blender/
bpyruntime instead of relying only on bundled docs. - Process isolation: command-line executions are bounded by explicit timeouts, output caps, compact JSON framing, and source-file overwrite checks. This is crash/process-state isolation, not an OS sandbox.
- Benchmark tooling: deterministic token-efficiency tasks, exploratory creative comparison harnesses, and a portable model-neutral full-27 BlenderBench runner with pinned inputs and post-generation scoring.
Current publication status
Developer-preview cleanup is in progress. Before publishing, complete PUBLICATION_CHECKLIST.md, especially package naming, fresh-clone install smoke tests, and tracked-file secret scanning.
Overview
A lightweight MCP (Model Context Protocol) server for Blender. It offers a natural language interface with Blender’s Python API, improving access to documentation, and allowing users to explore and understand complex setups.
Read the documentation at blender.org/lab/mcp-server
The project is deliberately small, maintainable, and does no more than necessary. It has two components that communicate over a TCP socket:
- A Blender add-on that runs inside Blender and executes live-scene requests.
- An MCP server that runs as a separate process, launched by the
Установка
This server does not publish a one-line install command.
Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →Конфигурация
{
"mcpServers": {
"blender": {
"command": "uv",
"args": [
"--directory",
"/absolute/path/to/blender_mcp/mcp",
"run",
"blender-mcp"
],
"env": {
"BLENDER_MCP_CLI_BACKEND": "bpy",
"BLENDER_MCP_BPY_PYTHON": "/absolute/path/to/python-with-bpy"
}
}
}
}