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 插件，在 Blender 内部的后台线程上运行 MCP Streamable-HTTP 服务器

addon/blender_mcp_addon/ → 安装到 Blender

MiniMax Plugin V1

本地 MiniMax Code 插件，连接正在运行的 Blender MCP 服务器，并将其工具暴露给智能体

connector/ → 安装到 C:/Users/.../.minimax/plugins/blender-mcp/

Blender 插件是 Blender 侧状态的权威来源。MiniMax 插件只是一个轻量客户端，它调用 Blender 插件的 HTTP 端点——MiniMax 侧不会生成任何 Python 进程，因此不存在端口泄漏或生命周期混乱的问题。

为什么采用这种结构

  • Blender 内的单一安装路径 —— MCP 服务器使用 bpy 在进程内运行，因此无需 uvx/pipx 的折腾，也不用维护一对需要保持同步的 socket。

  • 基于 localhost 的 Streamable HTTP —— 适用于任何现代 MCP 客户端（MiniMax Code、Claude Desktop、Cursor），并且在 Blender 重启后仍然有效。

  • 插件内手写的 MCP 服务器 —— Blender 5.2 LTS 默认自带 Python 3.13，且不带任何外部包。一个约 300 行的 MCP 服务器，比引入 mcp[cli] 并修改 sys.path 更具可移植性。

  • 具备 streamable-http 能力的 MiniMax Plugin V1 —— 插件不派生出任何东西，它只是指向 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 视口侧边栏的 Blender MCP 选项卡中启动）。

  5. 你会在控制台中看到 [Blender MCP] Server listening on http://127.0.0.1:8765/mcp。

3. 验证

在 MiniMax Code 的对话中提问：

使用 blender connector：列出当前场景中的前 5 个对象。

你应该会看到智能体对你正在运行的 Blender 调用 tools/list。

工具清单

工具

用途

只读

get_addon_info

能力握手——名称、版本、协议、功能列表。请先调用此工具。

是

scene_info

场景摘要（对象、灯光、摄像机、帧）

是

list_objects

列出场景对象，可选类型过滤

是

get_object

对象完整详情（位置、旋转、缩放、修改器、材质）

是

create_object

创建基本体（立方体、球体、平面、圆柱体、圆锥体、圆环、空物体、摄像机、灯光）

否

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

添加修改器（细分、镜像、实体化、阵列、倒角）

否

remove_modifier

按名称移除修改器

否

frame_get / frame_set

读取 / 移动时间轴

混合

render_image

将当前帧渲染到文件

否

screenshot_viewport

捕获当前视口

否

execute_python

运行任意 bpy 代码（由 ast 校验保护）

否

ping

健康检查

是

此外，MiniMax 插件还附带一个 Skill（blender-mcp-quickstart），它为智能体提供一目了然的工具索引、安全规则和常用操作模式。在进行较复杂的操作之前，请先阅读它。

完整的 schema 和示例请参见 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