BlenderMCP 完整指南3 步用自然语言控制 Blender让 AI 直接替你建模【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcpBlenderMCP 是一款开源插件它通过 Model Context ProtocolMCP把 Blender 3D 接入你自选的任意大语言模型。装好之后你在 AI 助手里敲一句给我搭一个海滩场景Blender 里的模型、灯光和材质就会实时生成。这篇文章按你实际操作会经过的路线来组织装好 → 连上 → 用起来 → 按需定制 → 排错每一步只讲必要的事。它到底做了什么一条 AI 直达 Blender 的实时通道先纠正一个常见误解BlenderMCP 不是给 AI 装了个 Blender 外壳而是架了一条双向实时通道。整条链路只有三个角色你的 AI 客户端Claude Desktop、Cursor、VS Code 等MCP 服务器核心实现在 src/blender_mcp/server.py由客户端自动拉起Blender 内的插件 addon.py通过 TCP 9876 端口与服务器保持 JSON 通信通道打通后AI 对 Blender 的操控能力包括创建/移动/缩放/删除对象、改材质和颜色、读取完整场景状态对象、灯光、相机、截取视口截图让 AI看见自己的作品、在 Blender 内执行任意 Python以及从 Poly Haven、Sketchfab 拉取资产、用 Hyper3D / Hunyuan3D 生成 3D 模型。⚠️ 注意execute_blender_code会在 Blender 里执行任意 Python 代码用之前先保存你的工程文件。安全细节可看 SECURITY.md。三步装好 BlenderMCPuv、客户端配置、插件安装第 1 步装 uv别用 pip最低要求Blender 3.0、Python 3.10、最新版 uv。macOS 上直接brew install uvWindows / Linux 按 uv 官方说明安装并加入 PATH装完重启终端验证uvx可用。坑在这里pip install uv往往装不出uvx命令后面客户端会报spawn uvx ENOENT所以务必走官方安装方式。第 2 步把 blender-mcp 登记到 AI 客户端在 Claude Desktop 的claude_desktop_config.json设置 → 开发者 → 编辑配置中加入{ mcpServers: { blender: { command: uvx, args: [blender-mcp] } } }Cursor、VS Code 的 MCP 配置同理Windows 下把command换成cmd、args改成[/c, uvx, blender-mcp]。改完配置后要完全退出并重启客户端才生效。如果嫌 uv 麻烦也可以用pipx install blender-mcp替代。第 3 步在 Blender 里装插件git clone https://gitcode.com/GitHub_Trending/bl/blender-mcp打开 BlenderEdit → Preferences → Add-ons → Install...选择刚克隆下来的 addon.py勾选启用Interface: Blender MCP。升级版本时只需要下载最新的addon.py替换并在客户端里删掉旧的 MCP 服务器重新添加。第一次连接点亮 BlenderMCP 面板装好插件后按N呼出 3D 视图右侧边栏切到BlenderMCP标签页操作很简单可选打开Poly Haven开关允许 AI 下载 HDRI、材质和模型点击Connect to Claude按钮回到 AI 客户端——看到 锤子图标出现就说明 Blender 工具组已激活可以开工了日常玩法一句话让 AI 动手做场景连上之后提示词写得像给同事派活就行几类高频场景你想要的效果示例提示词从零搭场景建一个低多边形地牢门口有只巨龙守着金币改外观把场景里的车改成红色金属漆真实感环境用 Poly Haven 的 HDRI 搭个有岩石和植被的海滩AI 生成资产用 Hyper3D 生成一个花园小矮人灯光构图布一个摄影棚灯光相机改成等距视角两个让 AI 靠谱的小技巧① 复杂任务拆成多轮小请求一次让它干太多事容易超时② 让 AI 先截图看视口它支持读取截图来检查自己的作品再决定下一步怎么改。想接入 Sketchfab、Hyper3D 等资产服务需要先在Edit → Preferences → Add-ons → Blender MCP里填好 API 密钥会持久保存重启不丢对应的环境变量如BLENDERMCP_SKETCHFAB_API_KEY、BLENDERMCP_HYPER3D_API_KEY等。进阶定制远程主机、锁定版本与遥测开关用熟了之后你可能碰到这几个定制需求Blender 不在本机Docker / WSL / 远程机器在客户端配置里加env: { BLENDER_HOST: host.docker.internal, BLENDER_PORT: 9876 }WSL2 里调 Windows 版 Blender 可试试BLENDER_HOST127.0.0.1Python 版本冲突在args里加[--python, 3.11, blender-mcp]并设置env: { UV_PYTHON_PREFERENCE: only-managed }可绕开 conda / pyenv 环境的干扰Apple Silicon 架构报错cryptography wheel 装成 x86_64args 改用[--python, 3.11-aarch64, blender-mcp]不想上报使用统计遥测是可选的默认只收集工具名、耗时、版本等平台无关信息凭据类字符串会在上报前被剔除。想彻底关闭就设BLENDER_MCP_DISABLE_TELEMETRYtrue或在 Blender 插件偏好里取消勾选相关逻辑在 src/blender_mcp/telemetry.py 和 src/blender_mcp/config.py想自己加功能的话MCP 工具都集中在 src/blender_mcp/server.py每个工具对应一个函数Blender 侧的接口和面板逻辑在 addon.py包入口是 main.py依赖定义见 pyproject.toml。另外插件里做了 Blender 4.0 的 shader 节点兼容分支ShaderNodeSeparateColor与旧版ShaderNodeSeparateRGB所以建议用 4.x / 5.x 版本且一定要用图形界面模式打开 Blenderblender -b后台模式没有视口和 MCP 端口可用。常见问题速查连不上、找不到 uvx、操作超时AI 说连不上 Blender确认侧边栏里插件服务器已启动不要手动去跑 uvx服务器由客户端启动第一条命令偶发失败很正常重试一次报spawn uvx ENOENTGUI 客户端不继承终端的 PATH。先which uvxmacOS/Linux或where uvxWindows拿到完整路径填进配置的command字段⏱️复杂操作超时把大请求拆成多个连续的小提示词分步执行缓存里的旧版本捣乱uv cache clean blender-mcp uvx --refresh blender-mcp刷新还是不行老办法但有效——重启 MCP 客户端和 Blender 里的服务器两边都重启项目基于 MIT 许可完整条款见 LICENSE正式接入工作流前建议花两分钟浏览 SECURITY.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），仅供参考