用自然语言驱动Blender:BlenderMCP上手实操笔记
2026/9/8 1:37:31 网站建设 项目流程

用自然语言驱动Blender:BlenderMCP上手实操笔记

【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcp

BlenderMCP 是一个通过 Model Context Protocol(MCP)把 Blender 3D 与任意大模型(如 Claude)连起来的开源项目,核心就两部分:一个 Blender 插件加一个 MCP 服务器。装好之后,你直接用自然语言就能让 AI 在 Blender 里创建对象、调材质、检查场景、执行 Python 代码。适合想用 AI 辅助 3D 工作的新手,以及想把 Blender 操作对话化的开发者。

🔄 它到底怎么工作:AI 的话怎么变成 3D 操作

整个系统是两层桥。AI 客户端(Claude Desktop、Cursor 等)与 MCP 服务器之间走 MCP 协议,服务器核心代码在 src/blender_mcp/server.py;服务器把每次工具调用翻译成 JSON 命令,通过 TCP 发出去,默认连 localhost:9876。这个端口另一端是 addon.py 在 Blender 内部启动的 socket 服务,插件用 bpy 真正执行操作,再把结果送回给 AI。一次完整往返是:你的提示 → AI 决定调哪个工具 → 命令进入 Blender → 执行结果或视口截图返回。

🛠️ 从零到跑通:安装 BlenderMCP 并配好 MCP 连接

前提有三条:Blender 3.0 以上(推荐 4.x/5.x,必须是正常 GUI 会话,不是 blender -b 后台模式)、Python 3.10+、uv 包管理器。

第一步,装 uv。Mac 用 brew 即可;Linux 跑官方安装脚本;Windows 用 PowerShell 执行官方一行安装脚本,装完把 .local\bin 加进 PATH 并重启客户端。

brew install uv

执行完在终端敲 uv --version,能看到版本号就说明这一步没问题。

第二步,把插件装进 Blender。从仓库下载 addon.py,在 Blender 里走 编辑 > 偏好设置 > 插件 > 安装,选中该文件并启用 "Interface: Blender MCP"。完成后,3D 视图侧边栏会多出一个 BlenderMCP 标签页。

第三步,配置 MCP 客户端。以 Claude Desktop 为例,打开 设置 > 开发者 > 编辑配置,在 claude_desktop_config.json 里加上下面这段。如果客户端报找不到 uvx,先用 which uvx(Windows 用 where uvx)拿到完整路径填进 command。

{ "mcpServers": { "blender": { "command": "uvx", "args": ["blender-mcp"] } } }

MCP 服务器由客户端自动拉起,不要手动去跑 uvx;改完配置记得把客户端完全退出再重开。

第四步,在 Blender 里建立连接。在 3D 视图按 N 打开侧边栏,切到 BlenderMCP 标签(顺手勾上 Poly Haven 可以启用资产下载),点击 Connect to Claude。连上之后 AI 客户端里会出现一个小锤子图标,表示 Blender 工具已就绪。

🎬 拿它实际做点什么:三个真实提示词示例

🧊 从零开始:一句话搭一个地牢场景

你说:"Create a low poly dungeon with a dragon guarding gold"(做个低多边形地牢,有条龙守着金子)。它做的:AI 先调 get_scene_info 查当前场景状态,再通过 bpy 逐个创建对象、摆放、上色。你得到的:执行后视口通常会出现一个完整的低模地牢,可以直接架相机出图。

🎨 精修:改已有模型的材质与灯光

你说:"Make this car red and metallic",再补一句 "Studio lighting, isometric camera"。它做的:调整现有对象的材质属性与灯光参数,过程中还能截视口图核对效果。你得到的:几轮交互后通常能看到外观变化,不满意继续补一句就能修正。

🏖️ 跨工具组合:资产库搭海滩场景

你说:"Beach scene with Poly Haven HDRIs, rocks, and vegetation"。它做的:在开了 Poly Haven 选项的前提下,AI 通过 API 搜索并下载 HDRI 环境光和岩石模型,再和程序化几何体拼到一起。你得到的:一个混了专业资产库素材和基础几何体的场景,比纯手搓基本体有氛围得多。

📌 值得留意的细节:安全边界、环境变量与一个小坑

容易被忽略的点有三处。一是安全边界:execute_blender_code 会在 Blender 里跑任意 Python,做高自由度指令前先把 .blend 存盘。二是部署方式:MCP 服务器和 Blender 不在同一台机器时(Docker、WSL、远程主机),要通过环境变量 BLENDER_HOST / BLENDER_PORT(默认端口 9876)指到目标,Docker 里 host 填 host.docker.internal。三是一个小坑:连接后的第一条命令偶尔会失败一次,让客户端再发一次就行。另外项目默认收集匿名使用统计,介意可在环境变量里加 BLENDER_MCP_DISABLE_TELEMETRY=true 完全关掉。

项目迭代比较快,近期版本加入了 Hunyuan3D 模型生成、Sketchfab 搜索和视口截图能力,仓库版本号已到 1.8.4。下一步建议:先把连接跑通,然后照着 README 的示例提示词列表跑一条;卡壳时翻一翻 Issue 列表,大概率有人踩过同样的坑。

【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcp

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询