一句话操作Blender：BlenderMCP自然语言3D建模完全指南

一句话操作BlenderBlenderMCP自然语言3D建模完全指南【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcp移动模型、调材质参数、打灯光、等渲染预览——Blender 里这些重复劳动现在可以直接交给 AIBlenderMCP 通过 MCP 协议把 Blender 接入 Claude 等 LLM一句自然语言就能搭好场景、生成玻璃材质。效果速览接好之后你在 AI 助手里聊天Blender 里实时响应物体操作创建、移动、缩放、删除全部用自然语言下发材质控制一句话把物体变成红色金属或生成带折射的玻璃材质场景检查AI 能读取整个场景物体、灯光、相机还能截屏看到视口素材获取Poly Haven 的 HDRI/纹理一键下载、Sketchfab 搜模型、Hyper3D 生成 3D 模型你不用记任何 Python API——会描述需求就行代码由 AI 生成并执行。它是怎么工作的一条三件套链路addon.py装进 Blender 的插件点 Connect 后在 Blender 内部起一个 Socket 服务器默认监听localhost:9876。src/blender_mcp/server.pyMCP 服务器把场景查询、创建物体、执行代码、下载资产等能力封装成标准 MCP 工具供 LLM 调用底层用 JSON over TCP 和插件通信。LLM 客户端Claude Desktop、Cursor、VS Code 等通过 MCP 协议接入。整体链路是LLM 客户端 -- MCP -- MCP 服务器 -- TCP:9876 -- Blender 插件一条命令形如{type: create_object, params: {...}}Blender 执行后返回结果。依赖与打包信息见 pyproject.toml。10分钟从零搭建系统要求Blender 3.0推荐 4.x/5.x、Python 3.10、uv。装 uv别用pip install uv它可能不会生成uvx命令# macOS brew install uv # Linux curl -LsSf https://astral.sh/uv/install.sh | sh配置 AI 客户端。以 Claude Desktop 为例Settings Developer Edit Config在claude_desktop_config.json里加{ mcpServers: { blender: { command: uvx, args: [blender-mcp] } } }装 Blender 插件下载仓库里的addon.py在 Blender 中 Edit Preferences Add-ons Install... 选择该文件启用Interface: Blender MCP。建立连接打开 3D 视图侧边栏按N呼出找到BlenderMCP标签点击Connect to Claude。连接成功后 AI 端会出现锤子图标表示 Blender 工具已就绪。可选在同一标签开启 Poly Haven 开关让 AI 能直接下载 HDRI 与纹理。动手实操一句话生成玻璃材质你要做的场景里建个立方体选中它对 AI 说创建一个玻璃材质折射率 1.5应用到选中的立方体。预期看到什么AI 先检查场景再生成 Python 代码——给 Principled BSDF 节点设Transmission 1.0、IOR 1.5、Roughness 0.02并接到材质输出上。视口里的立方体变成透明玻璃渲染预览能立刻看到折射扭曲。核心代码其实就是这几行principled.inputs[Roughness].default_value 0.02 principled.inputs[Transmission].default_value 1.0 principled.inputs[IOR].default_value 1.5 # 折射率 links.new(principled.outputs[BSDF], output.inputs[Surface])不满意就接着说加一点色散表面做点细微不规则模拟真实玻璃的瑕疵——AI 会读取现有节点再补改进代码。让AI看到视口自己调环境光你要做的发指令下载一个室内 HDRI放一个透明玻璃球调整相机角度展示球体对背景的折射。预期看到什么AI 搜索并下载 Poly Haven HDRI、设为世界环境、建球体并套用折射材质、摆好相机。关键在于它还能调get_viewport_screenshot拿到视口截图自己检查构图和亮度再回头微调相机位置与灯光强度——形成操作 → 看 → 修正的闭环这是它和盲写代码的本质区别。创意组合生成模型再拼场景你要做的用 Hyper3D 生成一个水晶雕塑然后给它套折射率 1.52 的材质或者在 Sketchfab 搜一个岩石模型放进场景加上摄影棚灯光和等轴测相机。预期看到什么AI 调用对应的生成/搜索接口把模型导入场景并完成布光。生成模型、Poly Haven 环境、Sketchfab 资产三样拼起来几个对话回合就能搭出接近完整的场景哪里不对劲再用把这辆车改成红色金属这类指令定点修复材质即可。踩坑记录现象客户端报spawn uvx ENOENT。原因GUI 客户端不继承你终端的 PATH找不到uvx。解法运行which uvxmacOS/Linux或where uvxWindows把得到的完整路径填进配置的commandWindows 也可写成command: cmd, args: [/c, uvx, blender-mcp]。现象AI 提示连不上或第一条指令报错。原因Blender 里插件的 Socket 服务器还没启动。解法确认 BlenderMCP 侧边栏中 addon 服务器已运行第一条指令失败很常见原样重试一次通常就好。现象Apple Silicon 上 cryptography wheel 构建报错。原因uvx在 arm64 Mac 上按 x86_64 构建。解法配置里指定架构args: [--python, 3.11-aarch64, blender-mcp]。现象复杂操作超时。原因单条指令动作太多超过 180 秒的 Socket 超时。解法把请求拆成小步骤的连续指令——先建物体再调材质最后打光。现象误操作后场景被改乱。原因execute_blender_code会在 Blender 里执行任意 Python。解法发指令前先保存文件出问题及时撤销或重开文件。下一步远程部署BLENDER_HOST/BLENDER_PORT环境变量、API 密钥配置、遥测关闭BLENDER_MCP_DISABLE_TELEMETRYtrue等细节见 README.md。再给两条建议指令里带具体数字折射率 1.52 比有点通透稳定得多复杂场景拆成多轮对话逐步搭建别指望一条指令出全片项目以 MIT 协议开源遇到 bug 或有新想法欢迎提 Issue 或提交 PR。【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考