AI 客户端
在支持 MCP 的客户端里输入需求，也可以上传参考图并补充尺寸、风格、用途和限制。
Blender Lab / MCP Server
Blender MCP Server
用自然语言把 AI 客户端连接到 Blender。上传参考图，描述你想要的模型、材质或场景， AI 可以通过 Blender Python API 读取当前文件、创建对象、调整节点、分析性能并整理资产。
- 适用版本
- Blender 5.1+
- 默认端口
- localhost:9876
- 安装包
- 16 KB
它解决什么问题
让 AI 真正进入 Blender 工作现场
普通聊天机器人只能给你教程或代码片段；MCP Server 会把 AI 客户端、MCP 服务和 Blender 插件连成一条本地通道。 你在 AI 里提出需求，AI 通过接口向 Blender 发出操作，再把结果反馈给你。
3 个部分
工作方式一眼看懂
MCP Server
把 AI 的请求转换成 Blender 可执行的操作，并通过本地连接发送给 Blender 插件。
Blender 插件
在当前 Blender 会话中读取场景、执行脚本、创建对象、修改材质节点或返回分析结果。
安装与连接
先装 Blender 插件，再把 AI 客户端接到本地端口
推荐先在一个空白 Blender 文件里测试连接，确认 AI 能创建简单对象后，再打开真实项目文件。
- 安装 Blender 5.1 或更新版本 打开系统偏好设置，允许 Blender 使用在线访问权限。
-
安装 Blender 插件包
把
mcp-1.0.0.zip拖入 Blender，或在扩展偏好设置里选择从磁盘安装。 -
启动 Bridge Server
进入插件偏好设置，确认 Host 为
localhost、Port 为9876，点击 Start。 -
安装 MCP Server 本体
在官方 Release 获取支持客户端导入的
.mcpb包，或按源码说明安装命令入口blender-mcp。 -
配置 AI 客户端
让客户端启动
blender-mcp，并连接本机 Blender 插件端口。
客户端配置
常见连接方式
不同 AI 客户端的 MCP 配置界面会略有差异，核心参数通常是服务器命令、工作目录和 Blender 本地端口。
在客户端的 MCP 设置中新增一个 Blender 服务，指向你安装的 MCP Server。保存后重启客户端，再让它测试 Blender 场景读取。
{
"mcpServers": {
"blender": {
"command": "blender-mcp",
"args": ["--host", "localhost", "--port", "9876"]
}
}
}如果你使用本地模型界面，确保模型支持工具调用，并在工具/MCP 管理处添加 Blender Server。
服务名称: blender
连接地址: localhost:9876
用途说明: 让 AI 读取并操作当前 Blender 文件连接成功后，先让 AI 执行一个不会破坏文件的小任务。看到 Blender 场景有变化，就说明链路打通了。
请读取当前 Blender 文件，告诉我场景里有多少个对象。
然后新建一个名为 MCP_Test_Cube 的立方体，尺寸为 1 米，放在世界原点。参考图建模
把参考图交给 AI，再让它在 Blender 里分步搭建
参考图本身通常上传到 AI 客户端，而不是上传到 Blender 插件。你可以让 AI 先观察图片， 再把建模任务拆成结构、比例、材质、灯光、检查五个阶段。
参考图提示词模板
我上传了一张参考图。请在 Blender 中按阶段建模：
1. 先分析主体结构、比例、关键轮廓和可见材质。
2. 用基础几何体建立低模草稿，命名所有对象。
3. 根据参考图补充主要细节，不要一次性生成过重网格。
4. 添加基础材质、相机和灯光，保持可编辑。
5. 完成后列出你创建的对象、材质和下一步可优化项。
Reference.jpg
Blender Scene
对象 / 材质 / 灯光 / 相机
可做什么
不只是建模，也能分析和整理复杂文件
自然语言控制
让 AI 读取当前场景、回答对象关系、创建测试模型、调整材质和渲染设置。
场景体检
查找高面数对象、异常法线、未命名材质、绝对路径、渲染内存风险等问题。
节点说明
为几何节点添加框架、命名和说明，也可以生成 Text 数据块作为文件内文档。
Example 2: Various Prompts
把完整提示词粘贴给 AI
下面这些案例来自 Blender MCP 的典型测试方向。为了稳定执行，请复制完整 Prompt； 如果涉及演示文件，建议先下载对应 Demo 打开后再运行。最终效果会受 AI 模型能力、客户端工具调用能力和当前 Blender 文件复杂度影响。
| Use Case | Prompt | Demo File | Result | 操作 |
|---|---|---|---|---|
| Data-block renaming: fix typos 数据块重命名：修正拼写错误 | With the current open Blender file fix the name of all the data-blocks to remove typos. Report back which data-blocks got fixed. |
Scattering Pebbles | GRP-rocks -> GRP-pebble, LGT-Lights -> LGT-lights, Compositing Nodetree -> Compositing Node Tree | |
| Data-block renaming: better names 数据块重命名：使用更清晰的名称 | With the current open Blender file suggest descriptive names for all data-blocks, and apply if approved. |
Scattering Pebbles | Camera -> CAM-main, Area -> LGT-sun-key, Area.001 -> LGT-sun-fill, Area.002 -> LGT-area-rim, GEO-pebble.001 -> GEO-pebble-B... | |
| Querying data relations 用自然语言查询数据关系 | Which objects are using the following material: pebbles |
Scattering Pebbles | 7 objects: GEO-pebble, GEO-pebble.001, GEO-pebble.002, GEO-pebble.003, GEO-pebble.004, GEO-pebble.005, GEO-pebble.006 | |
| Scene debugging 场景调试：查找最高面数对象 | What is the object with the highest poly-count on this file? Ignore objects which are not linked to any scene. |
Scattering Pebbles | GEO-ground with 4,096 faces. | |
| Geometry Nodes Documentation 几何节点文档化 | With the current open Blender file explain what the main geometry nodes setup is doing. Add inline documentation for it with frame elements. Create a Text data-block with the result of analysis. |
Scattering Pebbles | 4 major color-coded frames + text file with explanation. |
提示词小建议
如果你希望 AI 修改文件，先要求它“列出计划并等待确认”；如果你希望它直接执行，则明确写出尺寸、命名规范、是否允许删除对象、是否允许应用修改器。
扩展模板
更多适合 Blender MCP 的任务
创建模型草稿
根据参考图建立低模结构，保持对象命名清晰，先不要应用不可逆修改。
优化复杂场景
找出相机视角里显示很小但面数很高的对象，并给出可执行的优化建议。
整理资产命名
修正拼写错误，统一对象、材质、灯光、相机、纹理和集合的命名规范。
解释节点网络
阅读几何节点或材质节点，把作用分区写成可维护的说明。
参考图精修
在已有草稿上按参考图补充比例、边缘、凹凸和关键视觉特征。
材质快速搭建
为选中对象创建基础 PBR 材质，并保留可继续编辑的节点结构。
灯光与相机
自动创建展示用相机、三点布光和基础渲染设置。
网格问题检查
查找非流形、翻转法线、重复点、未应用缩放等常见问题。
渲染内存优化
检查高分辨率纹理、细分级别、实例化、阴影和不可见对象。
动画检查
查看关键帧、约束、驱动器和骨架绑定是否存在明显问题。
导出前检查
按交付清单检查命名、材质、贴图路径、尺寸单位和文件整洁度。
生成学习说明
把复杂文件变成可学习文档，适合团队交接或教程制作。
还可以继续探索
- Translate all the data-blocks from French to English.
- My mesh is not being deformed by my armature, how can I fix that?
- Blender is running out of memory rendering this scene, how can I optimize it?
- This mesh has strange shading artifacts, can you help me fix that?
- Find objects that have meshes with bad normals.
- Check my scene for non-uniformly transformed mesh objects.
- The video I exported does not play in web browsers, which settings should I change?
- Which sculpt brushes should I use for creating and detailing tree branches?
- Set up compositing nodes to save my image both as SDR and HDR.
- Verify this checklist: meshes must be manifold, all objects must have materials, naming must follow convention, no absolute paths.
安全提醒
先在测试环境里使用
MCP Server 会让 AI 生成的代码在 Blender 中执行。请不要在包含敏感文件、商业资产原件或重要项目唯一副本的环境里直接测试。
- 使用副本文件或版本控制。
- 先让 AI 列计划，再授权它执行。
- 避免给 AI 访问私人目录、密钥、客户资料或未备份工程。
- 遇到不确定命令时，要求 AI 解释它将修改哪些对象。
FAQ
常见问题
它会替我“一键生成完美模型”吗？
更准确地说，它是一个 AI 操作 Blender 的接口。复杂模型建议分阶段生成：先比例和结构，再细节、材质、灯光，最后人工微调。
参考图上传到哪里？
上传到支持图片理解的 AI 客户端。AI 读懂参考图后，通过 MCP 在 Blender 里执行建模步骤。
为什么 Blender 里没有反应？
通常需要检查三件事：插件是否启用、Bridge Server 是否正在运行、AI 客户端是否连接 localhost:9876。
它适合哪些人？
适合想用 AI 辅助建模、整理文件、调试节点、学习 Blender API、分析复杂场景的艺术家、技术美术和开发者。