
Blender MCP
Связывает агента с запущенным Blender: агент пишет Python для модели, света и материалов, сам смотрит на сцену с разных ракурсов и подтягивает ассеты из Poly Haven, Sketchfab и Poly Pizza.
Раньше назывался blender-mcp; старая команда uvx blender-mcp тоже запускает сервер.
Как подключить
Что сделать до подключения
Blender 3.0 или новее, Python 3.10 или новее и менеджер пакетов uv
Поставить аддон командой uvx mcp-for-blender install-addon или вручную: Edit → Preferences → Add-ons → Install… и выбрать addon.py
Включить аддон Interface: MCP for Blender в Edit → Preferences → Add-ons
В 3D-окне нажать N, открыть вкладку MCP for Blender и нажать Start MCP Server, если сервер не запустился сам
BLENDERMCP_POLYPIZZA_API_KEYнеобязательно: бесплатный ключ на poly.pizza/settings/api для low-poly моделей
BLENDERMCP_MESHY_API_KEYнеобязательно: ключ Meshy для генерации моделей, нужен платный тариф Meshy
Конфиг для вашего клиента
Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code
claude mcp add --transport stdio blender \
-- uvx mcp-for-blenderПроверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.
Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex
[mcp_servers.blender]
command = "uvx"
args = ["mcp-for-blender"]Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.
Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor
{
"mcpServers": {
"blender": {
"command": "uvx",
"args": ["mcp-for-blender"]
}
}
}Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.
Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code
{
"mcpServers": {
"blender": {
"type": "stdio",
"command": "uvx",
"args": ["mcp-for-blender"]
}
}
}Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.
Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code
{
"mcpServers": {
"blender": {
"command": "uvx",
"args": ["mcp-for-blender"]
}
}
}Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.
Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI
{
"mcpServers": {
"blender": {
"command": "uvx",
"args": ["mcp-for-blender"]
}
}
}Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.
Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"servers": {
"blender": {
"type": "local",
"command": ["uvx", "mcp-for-blender"]
}
}
}
}Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.
Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop
{
"mcpServers": {
"blender": {
"command": "uvx",
"args": ["mcp-for-blender"]
}
}
}Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.
Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio
{
"mcpServers": {
"blender": {
"command": "uvx",
"args": ["mcp-for-blender"]
}
}
}Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.
Инструменты сервера
execute_blender_codeвыполняет Python в Blenderlookпоказывает сцену с выбранного ракурсаget_scene_infoкратко описывает объекты сценыgenerate_3dгенерирует и импортирует 3D-модельsearch_assetsищет HDRI, текстуры и моделиimport_assetзагружает ассет в сценуget_addon_statusпоказывает версии и включённые источникиdisable_telemetryотключает сбор данныхrecord_trajectory_feedbackзаписывает отзыв о сессииЧто попросить агента
Для каких задач
Ограничения
execute_blender_code выполняет любой Python внутри Blender: сохраняйте файл перед работой или включите проверку скриптов BLENDER_MCP_SAFE_MODE=1
Сокет аддона работает без пароля и шифрования: кто достучится до порта, тот выполнит код в Blender, поэтому держите его на localhost
Запускайте только один экземпляр сервера: два клиента сразу, например Cursor и Claude Desktop, мешают друг другу
Без настройки сервер отправляет анонимную статистику вызовов; отключается переменной DISABLE_TELEMETRY=true