BlenderMCP 教程5 分钟把 Claude 接入 Blender一句话生成完整 3D 场景【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcp输入一句创建一个现代客厅不到一分钟Blender 视口里出现了沙发、茶几、地毯和灯光。这就是 BlenderMCP 的工作方式你用自然语言提需求AI 在 Blender 里动手。项目速写AI 与 Blender 3D 之间的桥梁BlenderMCP 是一个社区开源项目MIT 协议通过模型上下文协议MCP让大模型统一调用外部工具的协议把 Blender 接到 Claude 等 AI 助手上。原理一句话MCP 服务器进程与 Blender 内的插件通过 TCP Socket 通信AI 把语言指令翻译成 Blender 操作。核心能力就四样自然语言创建、移动、缩放、删除 3D 物体场景检查AI 能读取场景状态还能对视口截图看到当前画面材质控制以及从 Poly Haven 下载 HDRI、纹理和模型直接在 Blender 里执行 Python 代码能力最强也最需要留意安全安装 uv 与 Blender 插件配置 Claude 连接系统要求Blender 3.0 及以上4.x / 5.x 更佳且必须用 GUI 窗口运行不能用blender -b后台模式Python 3.10uv 包管理器Astral 出品的 Python 包管理工具比 pip 快uvx可以免安装直接跑工具先装 uv按平台三选一Mac 安装 uvbrew install uvWindows 安装 uvpowershell -c irm https://astral.sh/uv/install.ps1 | iex装完重启终端。Windows 用户注意把%USERPROFILE%\.local\bin加入 PATH。Linux 安装 uvcurl -LsSf https://astral.sh/uv/install.sh | sh不要用pip install uv那样可能不会生成uvx命令。然后是 Blender 插件。克隆仓库拿到 addon.pygit clone https://gitcode.com/GitHub_Trending/bl/blender-mcp在 Blender 里依次点 Edit → Preferences → Add-ons → Install...选择克隆下来的addon.py启用Interface: Blender MCP。插件会在 9876 端口起一个 Socket 服务器等着 MCP 进程来连。最后配置 AI 客户端。以 Claude 桌面版为例编辑claude_desktop_config.json{ mcpServers: { blender: { command: uvx, args: [blender-mcp] } } }Windows 下uvx可能是脚本要写成command: cmd, args: [/c, uvx, blender-mcp]。改完配置后完全退出并重启客户端。验证成功打开 Blender 按N调出侧边栏在BlenderMCP标签页确认 Host 为localhost、Port 为9876点Connect to Claude。连接建立后Claude 工具栏会出现一个锤子图标说明 Blender 工具已激活。核心工作流一句话生成完整客厅场景下面用一个从零搭出客厅的任务走完全程。在 Blender 插件里建立连接侧边栏的 BlenderMCP 面板里Host 和 Port 保持默认直接点Connect to Claude。此时插件端确认服务器已在监听MCP 进程随后握手。如果面板显示已连接但 Claude 侧没反应把第一条指令重发一次——首条指令偶发失败是已知现象。一句话生成客厅连接就绪后在 Claude 对话框里输入创建一个现代风格客厅灰色织物 L 形沙发、直径 80cm 的玻璃茶几、1.8m×2.0m 的米色地毯地板用浅色木纹材质十几秒后视口里出现整套家具。背后发生的事AI 先调用get_scene_info读取当前场景再通过execute_blender_code在 Blender 里执行 Python 代码逐个建出物体并赋材质。你不需要懂 PythonAI 负责翻译。微调细节让 AI 看着改接着提第二条把茶几移到沙发前 20cm材质改成深色胡桃木再在角落加一盏落地灯这条指令的关键是get_viewport_screenshotAI 会对视口截图看一眼判断家具相对位置后再动手。所以改完的结果不是盲改而是它确认过画面的。不满意就继续说地毯换灰蓝色、落地灯移到右侧每轮都是检查 → 修改 → 确认的循环。进阶配置三个真正改变体验的细节开启 Poly Haven拿到真实光照默认场景光是平的画面塑料感重。在 BlenderMCP 侧边栏勾选Poly Haven后对它说下载一张日落 HDRI 并设置为世界环境。改前是均匀灰白光照改后是带方向和色温的真实光影渲染预览立刻像样。⏱大任务拆成三步别指望一句话通吃一条指令塞进几十件物体容易超时。拆成三段顺序执行改前一句创建完整卧室包含床、衣柜、书桌、台灯……20 件物品 → 中途超时场景半成品改后先3m×4m×2.8m 房间框架加窗户再床和两个床头柜最后地毯、挂画、暖色灯光 → 每步都稳中间还能随时插一句调整关掉匿名遥测默认会收集匿名使用统计工具名、耗时、版本敏感内容会在上传前被剔除。不想发任何数据在客户端配置里加环境变量env: { BLENDER_MCP_DISABLE_TELEMETRY: true }改完重启客户端telemetry模块启动时直接跳过上报。细节见 SECURITY.md。常见坑点与排错现象客户端报错spawn uvx ENOENT原因图形界面客户端不继承你终端的 PATH找不到uvx解决终端执行which uvxmacOS/Linux或where uvxWindows把输出的完整路径填进配置的command字段重启客户端。现象点了 Connect 没反应锤子图标不出现原因MCP 服务器没被拉起来。uvx不要手动运行是客户端自动启动它的解决确认插件已启用且端口 9876 没被另一个 Blender 实例占用首条指令失败就重发一次。现象复杂指令执行到一半超时原因单次 Python 执行时间过长解决按结构 → 家具 → 装饰拆成多条短指令顺序发送别合并。现象Apple Silicon 上报 x86_64 架构错误cryptography wheel 相关原因uvx拉了 x86 版 Python解决参数改为args: [--python, 3.11-aarch64, blender-mcp]强制 arm64。现象conda / pyenv 环境下 Python 版本冲突原因客户端误用了系统里的旧 Python解决配置中加--python, 3.11参数和UV_PYTHON_PREFERENCE: only-managed仍异常时执行uv cache clean blender-mcp uvx --refresh blender-mcp清缓存重拉。它适合谁边界在哪BlenderMCP 最顺手的人群是三类做场景布局和氛围稿的 3D 爱好者、需要快速出方案比选的室内设计师、想练 Blender 又懒得背命令的新手。它生成几何体的方式偏基础基元加修改器做生产级高精度模型、复杂拓扑时还是得手动建模或导入高质量资产——把它当快速铺场 灯光材质试验台最合理。项目迭代很快当前版本 1.8.4以 pyproject.toml 为准已支持 Sketchfab 模型搜索、Hyper3D 与 Hunyuan3D 生成、视口截图和远程主机把 MCP 服务器跑在另一台机器上通过BLENDER_HOST/BLENDER_PORT环境变量指定。想深入可以看两处server.py 里所有 AI 可调用的工具定义addon.py 里 Blender 端的实现。项目仓库git clone 用https://gitcode.com/GitHub_Trending/bl/blender-mcp完整文档与更新日志README.mdMCP 服务器源码src/blender_mcp/server.pyBlender 插件源码addon.py安全与遥测说明SECURITY.md【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考