让 AI 直接操作 Blender：BlenderMCP 从接入到出片的完整工作流

让 AI 直接操作 BlenderBlenderMCP 从接入到出片的完整工作流【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcp如果你想在聊天窗口里用一句中文或英文就让 Blender 建对象、调材质、找贴图BlenderMCP 就是为此设计的开源项目它通过 MCPModel Context Protocol模型上下文协议把 Blender 接进 Claude、Cursor 等任意支持 MCP 的大模型客户端。本文面向会开终端但不熟悉本项目的读者目标很具体——半小时内跑通安装插件 → 建立连接 → 用自然语言搭一个可渲染的小场景并顺带把排错路径讲清楚。先确认环境BlenderMCP 的前置条件项目分为两端Blender 里装一个插件仓库根目录的addon.py机器上再跑一个 MCP 服务器入口是 src/blender_mcp/server.py。两端通过 TCP 9876 端口用 JSON 通信所以环境清单如下组件最低要求说明Blender3.0推荐 4.x/5.x必须是有图形界面的会话blender -b后台模式无法工作Python3.10由 uv 管理不需要手动安装uv最新版提供uvx命令由客户端用它拉起 MCP 服务器MCP 客户端任意Claude Desktop、Cursor、VS Code、Claude Code CLI 等网络可访问资产服务用到 Poly Haven / Sketchfab / Hyper3D 时需要联网一个容易踩的坑先说在前面官方明确提醒不要用pip install uv因为它可能不会生成uvx命令。uv 的安装方式按系统三选一# macOS brew install uv # WindowsPowerShell powershell -c irm https://astral.sh/uv/install.ps1 | iex # Linux curl -LsSf https://astral.sh/uv/install.sh | sh快速上手三步完成 Blender MCP 接入第 1 步获取仓库git clone https://gitcode.com/GitHub_Trending/bl/blender-mcp cd blender-mcp第 2 步在客户端注册 blender-mcp以 Claude Desktop 为例进入 Settings Developer Edit Config在claude_desktop_config.json中写入{ mcpServers: { blender: { command: uvx, args: [blender-mcp] } } }如果客户端找不到uvxGUI 程序不继承终端的 PATH先执行which uvxmacOS/Linux或where uvxWindows把输出的完整路径填进command。Cursor 的 Windows 用户则写成command: cmd, args: [/c, uvx, blender-mcp]。改完配置后完全退出并重启客户端。注意一个约束同一时间只跑一个 MCP 服务器不要同时开着 Cursor 和 Claude Desktop 都连 Blender。第 3 步在 Blender 里安装并启动插件打开 Blender进入 Edit Preferences Add-ons Install...选择仓库里的 addon.py启用Interface: Blender MCP按N打开 3D 视口侧边栏切换到BlenderMCP标签页点击Connect to Claude连接成功后客户端里会出现一个锤子图标表示 Blender 相关工具已激活。此时可以关闭 Blender 窗口之外的任何手动操作——服务器由客户端自己拉起你不需要自己敲uvx blender-mcp。连上之后先试哪几个命令MCP 服务器把 Blender 的能力暴露为一组工具在 server.py 中以mcp.tool()注册。对新手最有用的四个工具作用什么时候用get_scene_info返回当前场景的对象、灯光、相机等完整状态让 AI看清场景后再动手get_object_info查询单个对象的详细信息想精确修改某个对象时get_viewport_screenshot截取视口画面并回传给 AI让 AI 看到视觉效果自我校正execute_blender_code在 Blender 内执行任意 Python 代码前面工具覆盖不了的操作前三个在聊天里直接说就行例如看一下当前场景里有哪些对象。真正干活的是第四个AI 会拆解任务、生成bpy代码、逐段执行并看截图验证。官方文档特别提醒——execute_blender_code可以运行任意 Python用之前先保存工程文件并且复杂任务要拆成小步骤逐步执行。不止建模如何接入 Poly Haven 等资产库BlenderMCP 的另一块价值是资产管线在侧边栏勾选 Poly Haven 后你可以直接对 AI 说找一张傍晚的天空 HDRI 打光它会走search_polyhaven_assets搜索、download_polyhaven_asset下载、set_texture应用到对象的完整链路覆盖 HDRI、纹理和 3D 模型三类资产。另外两个可选的资产源Sketchfab搜索并导入 3D 模型需要 API KeyHyper3D Rodin / Hunyuan3D文字或图片生成 3D 模型Hyper3D 免费试用有每日限额建议申请自己的 key这些密钥不写进客户端配置而是存在 Blender 插件偏好里Edit Preferences Add-ons Blender MCP对应环境变量名如下这样重启 Blender 也不会丢密钥环境变量名Sketchfab API KeyBLENDERMCP_SKETCHFAB_API_KEYHyper3D API KeyBLENDERMCP_HYPER3D_API_KEYHunyuan3D SecretId / SecretKeyBLENDERMCP_HUNYUAN3D_SECRET_ID/BLENDERMCP_HUNYUAN3D_SECRET_KEY端到端小案例搭一个产品渲染场景下面是一条完整的自然语言工作流全程不需要打开 Blender 的菜单假设你已经装好一个产品模型或让 AI 建一个简单几何体代替告诉 AI 现状发送先看一下当前场景它会调用get_scene_info确认模型、灯光、相机的存在情况。布置打光发送加一个三点布光主光用 Poly Haven 的黄昏 HDRI资产检索与下载在同一条指令里完成。调整材质发送把产品外壳改成金属质感粗糙度 0.2。如果第一步效果不对AI 会自己截图回看再修——这也是截图工具存在的意义。摆好相机发送用等距视角的相机对准产品。人工验收在 Blender 视口里确认构图和材质不满意就继续用文字追加修改。整个过程里你可以随时用 Blender 界面手动干预比如微调相机角度下一轮对话时 AI 通过get_scene_info就能读到你的改动不会失忆。排错指南连接失败的排查顺序现象原因处理办法spawn uvx ENOENT客户端找不到 uvx 的完整路径which uvx/where uvx拿到绝对路径填入配置command第一条指令报错连接刚建立时的冷启动直接重试一次多数情况即恢复超时timeout单次请求太复杂把大任务拆成多条小指令逐步下发连接被拒 / 无响应Blender 插件未启动或 Blender 以后台模式运行确认侧边栏已点 Connect必须使用 GUI 版 BlenderPython 版本冲突机器上多个 Python 干扰 uv配置里加args: [--python, 3.11, blender-mcp]和env: {UV_PYTHON_PREFERENCE: only-managed}WSL / Docker 连不上宿主机的 Blender跨环境网络隔离在客户端配置中设置BLENDER_HOSTDocker 用host.docker.internal与BLENDER_PORT9876两个通用兜底动作彻底重启 MCP 客户端在 Blender 侧停止再重新点击 Connect。遥测相关的说明可参考 SECURITY.md若希望关闭匿名使用统计在客户端环境变量里加BLENDER_MCP_DISABLE_TELEMETRYtrue即可。下一步从哪里继续深入先跑通一个完整案例按上文的五步产品场景走一遍把文字 → 场景的手感建立起来读一遍服务器源码server.py 里每个mcp.tool()函数就是一个可用能力的定义照着工具列表可以精确知道自己能点名让 AI 做什么配置自己的资产密钥在 Blender 插件偏好里填入 Poly Haven 之外的 Sketchfab / Hyper3D 密钥解锁更多生成与检索能力。更多使用细节与最新版本变更以 README.md 为准项目条款见 TERMS_AND_CONDITIONS.md。【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考