BlenderMCP 三步连接教程:让AI控制Blender搭建3D场景

BlenderMCP 三步连接教程:让AI控制Blender搭建3D场景 BlenderMCP 三步连接教程让AI控制Blender搭建3D场景【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcpBlenderMCP 是一个把 AI 和 Blender 连起来的开源工具装好之后你可以用一句自然语言让 Claude 等 AI 助手直接在 Blender 里创建物体、调整材质、搭建完整 3D 场景。不需要会建模也不需要会写 Python。下文按装好 → 跑通 → 用好 → 玩高级的顺序带你从零走到第一个场景。安装先备好三样东西整个系统由三个部分组成缺一不可组件作用AI 客户端如 Claude Desktop你负责对话的那一端blender-mcp 服务器Python 程序把你的话翻译成 Blender 能执行的指令Blender 插件addon.py在 Blender 内部接收指令并动手干活三者之间走的是本地 TCP 连接默认端口 9876来回传输 JSON 消息所以环境要求很低Blender 3.0 以上推荐 4.x/5.x且要用正常 GUI 版本、Python 3.10 以上、再装一个名为 uv 的包管理器。安装 uv按系统二选一各一条命令brew install uvpowershell -c irm https://astral.sh/uv/install.ps1 | iex注意不要用pip install uv它可能不会生成后面要用的uvx命令。把插件装进 Blender从项目仓库拿到 addon.py如果后续想改代码可以把整个仓库克隆下来git clone https://gitcode.com/GitHub_Trending/bl/blender-mcp然后打开 Blender编辑 → 偏好设置 → 插件 → 安装...选择addon.py再启用名为Interface: Blender MCP的插件。装完后不用做任何事它会在你点击按钮时才启动服务。三步跑通连接在 AI 客户端里加一段配置以 Claude Desktop 为例进入 设置 → 开发者 → 编辑配置claude_desktop_config.json加入{ mcpServers: { blender: { command: uvx, args: [blender-mcp] } } }Cursor、VS Code 的配置写法基本相同Windows 下要把command写成cmdargs 变成[/c, uvx, blender-mcp]。改完配置后完全退出并重启客户端。点两个按钮看到锤子图标在 Blender 里按N打开侧边栏切到BlenderMCP标签页先点Start MCP Server启动连接服务再点Connect to Claude。连接成功后Claude 界面会出现一个 锤子图标说明 Blender 工具已激活。用好三种指令写法一句话生成场景直接说需求即可例如Create a low poly dungeon with a dragon guarding gold创建一个低多边形地牢里面有一条龙守护金库AI 会自动创建地牢、龙和金子的模型摆放位置、基础材质都一并处理全程不用你碰鼠标。给具体数字效果更准指令越具体结果越可控。与其说做一个大桌子不如说创建一张 180cm×90cm×75cm 的长方形橡木餐桌桌腿为直径 8cm 的圆柱。同样地对已有物体说把汽车改成红色金属材质只改目标对象不会动其他东西。让 AI看见画面再调整BlenderMCP 支持视口截图AI 能看到当前 Blender 视口内容。你可以问现在场景长什么样哪里可以改进或者要求把镜头切到等轴测角度、打棚拍光。AI 会先截屏分析再下指令比盲目操作靠谱得多。玩高级接入三个资产库内置物体毕竟有限复杂场景可以调用外部资源Poly Haven免费 HDRI 环境、PBR 纹理和模型在侧边栏勾选启用即可可以说用 Poly Haven 的海边 HDRI 打光Hyper3D Rodin文字或图片直接生成 3D 模型免费额度每天有次数限制Sketchfab搜索并导入现成模型适合找特定家具、车辆Hunyuan3D腾讯的 3D 生成模型同样支持文字生 3D需要 API Key 的服务Sketchfab、Hyper3D 等在 Blender 的 偏好设置 → 插件 → Blender MCP 里填写即可配置会跨重启保留。踩坑与排错多数人遇到的 4 个问题第一条指令失败了这是已知现象官方文档明确说first command often fails; try again——直接重试一次通常就好。另外不要手动在终端跑uvx服务器由客户端自动拉起。报spawn uvx ENOENTGUI 客户端不继承终端的 PATH。用which uvxWindows 用where uvx查到完整路径把它填进配置的command字段。复杂操作超时别一句话让它做十件事拆成三五条顺序发送先搭结构再放家具最后调装饰。Python 版本冲突 / Apple Silicon 架构报错在配置 args 里加--python 3.11锁定版本Docker 或 WSL 环境下 Blender 和服务器不在同一台机器时用环境变量BLENDER_HOST、BLENDER_PORT指向正确的地址。⚠️ 两个安全提醒execute_blender_code工具可以在 Blender 里执行任意 Python 代码来源不明的指令先存盘再跑插件默认会上报匿名的使用统计不含提示词和截图细节介意的话设置BLENDER_MCP_DISABLE_TELEMETRYtrue或在插件里取消勾选即可。下一步做什么打开 Blender把 addon.py 装好并启用在 AI 客户端里加好上面那段 JSON 配置重启客户端点 Connect 看到锤子图标后发你的第一句指令创建一个低多边形地牢里面有一条龙守护金库想深入看细节可以阅读完整文档 README.md 和服务器核心源码 src/blender_mcp/server.py或到项目的 Discord 社区入口见文档提问。项目仓库地址git clone https://gitcode.com/GitHub_Trending/bl/blender-mcp【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcp创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考