BlenderMCP 实战教程3 步把 AI 接到 Blender用提示词直接建模【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcpBlenderMCP 是一个社区插件让任意 AI 助手Claude、Cursor、VS Code 等通过自然语言实时操控 Blender 3D你在对话框里说把车改成红色金属材质视口里的模型真的会变。适合刚接触 Blender 的新手、想提速的 3D 设计师以及所有想折腾 LLM 与本地工具联动的开发者。为什么需要它AI 会写 Blender 代码却点不动一个按钮你大概遇到过这个尴尬让 AI 帮你写一段 Blender Python它能写出来但还得你手动粘贴到脚本编辑器里跑想调个灯光、改个相机角度又要在一堆属性面板里翻半天。BlenderMCP 解决的就是最后一公里。它基于 MCPModel Context Protocol一套让 AI 调用本地工具的标准协议搭起一条双向通道AI 发出的指令直接变成 Blender 里的真实操作视口截图还能回传给 AI 让它看到你的场景。你只负责说需求它负责动手。3 步装好 BlenderMCP 并验证连接第一步装 uv负责启动 MCP 服务的命令行工具macOSbrew install uvWindows / Linux按 uv 官方安装脚本执行即可⚠️ 不要用pip install uv可能不会生成配套的uvx命令后面会报错。第二步装 Blender 端插件先把仓库拉到本地git clone https://gitcode.com/GitHub_Trending/bl/blender-mcp前提条件Blender 3.0 以上推荐 4.x / 5.x、Python 3.10。然后在 Blender 里依次点Edit Preferences Add-ons Install选中克隆下来的addon.py勾选启用Interface: Blender MCP。第三步在 AI 客户端里登记这台 Blender以 Claude Desktop 为例打开Settings Developer Edit Config在claude_desktop_config.json的mcpServers字段里新增一项名字填blendercommand填uvxargs填blender-mcp。改完完全退出客户端再重新打开改配置后不重启不生效。里程碑判断回到 Blender在 3D 视口按N键呼出右侧边栏切到BlenderMCP选项卡点击Connect to Claude。✅ 当面板显示已连接、客户端界面出现一个锤子图标说明链路已打通可以开始打字了。上手实操让 AI 用 3 句提示词搭出一个场景别一上来就丢大需求按先看清楚再分步做的节奏来让 AI 先看一眼连接成功后直接问现在场景里有什么。它会调用场景检查和视口截图工具把当前对象、灯光、相机状态读回来——这一步相当于对齐上下文。小步加东西比如创建一个低多边形石台观察视口变化再补一句加一盏顶光角度 45 度。一次只改一个东西出错了也方便定位。调整观感最后说相机切到等距视角材质换成深灰色金属这类指令收个尾。两条现场经验第一条指令偶尔会失败服务端是客户端首次调用时才拉起的再发一次通常就好复杂请求超时就拆成两三步小提示词依次下发。知其所以然BlenderMCP 的三方结构整条链路长这样AI 客户端 ←MCP 协议→ MCP 服务端 ←TCP 9876 端口→ Blender 插件中间跑的是 JSON 消息。addon.py跑在 Blender 内部既是监听 9876 端口的 socket 服务端也是你看到的那个 N 面板。收到指令后在这里执行真实的 Blender 操作。src/blender_mcp/server.pyMCP 服务端对外暴露get_scene_info、get_viewport_screenshot、execute_blender_code等工具并负责与 addon 的 socket 通信。main.py 与 pyproject.toml包入口和打包配置你配置里的uvx blender-mcp命令就定义在pyproject.toml的 scripts 段。src/blender_mcp/config.py遥测匿名使用统计的后端配置全部支持环境变量覆盖配套的telemetry.py、secret_store.py、secret_redact.py分别负责统计上报、API Key 加密存储和敏感信息脱敏。进阶与扩展改源码从这 4 个入口下手 想动手改的读者记住这几个文件就够了加工具在 server.py 里加一个 MCP 工具函数再到 addon.py 里补对应的命令处理两端各改一处。换地址MCP 服务跑在远程机器、Docker 或 WSL 里时用环境变量BLENDER_HOST/BLENDER_PORT指定 Blender 实际监听的地址和端口默认 localhost:9876。关遥测在客户端配置的env里加BLENDER_MCP_DISABLE_TELEMETRYtrue一行命令即可完全停用统计。接外部资产服务Sketchfab、Hyper3D、Hunyuan3D 的 API Key 存在 Blender 插件偏好里Edit Preferences Add-ons Blender MCP重启不丢不用每次写环境变量。避坑指南安装与连接最常见的 4 个卡点现象客户端报spawn uvx ENOENT。原因图形界面程序不会继承你终端里的 PATH找不到uvx。解法终端执行which uvxWindows 用where uvx拿到完整路径直接填进配置的command字段Windows 上可把command设为cmd、args设为/c uvx blender-mcp。现象点了 Connect第一条指令没反应或报错。原因MCP 服务是客户端首次调用时才启动的首次握手容易没跟上另外 Blender 必须以正常 GUI 方式运行blender -b后台模式下 socket 和视口工具都不可用。解法确认插件面板显示已连接然后把同一条指令重发一次不要手动去终端跑uvx启动交给客户端。现象Apple SiliconM1~M4机器上装依赖报 cryptography 构建失败提示在为 x86_64 编译。原因uvx默认选了与 Mac 架构不匹配的 Python。解法在配置的args里加上--python 3.11-aarch64强制使用 arm64 版 Python。现象一长串复杂操作走到一半超时。原因单条指令内部要执行的 Blender 操作太多超过 socket 的等待上限。解法把需求拆成 2~3 条连续的短句提示词逐条下发边看视口边确认。最后提醒一句安全边界execute_blender_code工具会在 Blender 里执行任意 Python用之前先 CtrlS 存好工程避免一次失误毁掉未保存的场景。动手之前两个延伸阅读装好之后从让 AI 复刻一张参考图开始练手是熟悉整套工作流最快的方式。协议细节和许可条款见 LICENSE 与 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），仅供参考 BlenderMCP 实战教程：3 步把 AI 接到 Blender，用提示词直接建模
BlenderMCP 实战教程3 步把 AI 接到 Blender用提示词直接建模【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcpBlenderMCP 是一个社区插件让任意 AI 助手Claude、Cursor、VS Code 等通过自然语言实时操控 Blender 3D你在对话框里说把车改成红色金属材质视口里的模型真的会变。适合刚接触 Blender 的新手、想提速的 3D 设计师以及所有想折腾 LLM 与本地工具联动的开发者。为什么需要它AI 会写 Blender 代码却点不动一个按钮你大概遇到过这个尴尬让 AI 帮你写一段 Blender Python它能写出来但还得你手动粘贴到脚本编辑器里跑想调个灯光、改个相机角度又要在一堆属性面板里翻半天。BlenderMCP 解决的就是最后一公里。它基于 MCPModel Context Protocol一套让 AI 调用本地工具的标准协议搭起一条双向通道AI 发出的指令直接变成 Blender 里的真实操作视口截图还能回传给 AI 让它看到你的场景。你只负责说需求它负责动手。3 步装好 BlenderMCP 并验证连接第一步装 uv负责启动 MCP 服务的命令行工具macOSbrew install uvWindows / Linux按 uv 官方安装脚本执行即可⚠️ 不要用pip install uv可能不会生成配套的uvx命令后面会报错。第二步装 Blender 端插件先把仓库拉到本地git clone https://gitcode.com/GitHub_Trending/bl/blender-mcp前提条件Blender 3.0 以上推荐 4.x / 5.x、Python 3.10。然后在 Blender 里依次点Edit Preferences Add-ons Install选中克隆下来的addon.py勾选启用Interface: Blender MCP。第三步在 AI 客户端里登记这台 Blender以 Claude Desktop 为例打开Settings Developer Edit Config在claude_desktop_config.json的mcpServers字段里新增一项名字填blendercommand填uvxargs填blender-mcp。改完完全退出客户端再重新打开改配置后不重启不生效。里程碑判断回到 Blender在 3D 视口按N键呼出右侧边栏切到BlenderMCP选项卡点击Connect to Claude。✅ 当面板显示已连接、客户端界面出现一个锤子图标说明链路已打通可以开始打字了。上手实操让 AI 用 3 句提示词搭出一个场景别一上来就丢大需求按先看清楚再分步做的节奏来让 AI 先看一眼连接成功后直接问现在场景里有什么。它会调用场景检查和视口截图工具把当前对象、灯光、相机状态读回来——这一步相当于对齐上下文。小步加东西比如创建一个低多边形石台观察视口变化再补一句加一盏顶光角度 45 度。一次只改一个东西出错了也方便定位。调整观感最后说相机切到等距视角材质换成深灰色金属这类指令收个尾。两条现场经验第一条指令偶尔会失败服务端是客户端首次调用时才拉起的再发一次通常就好复杂请求超时就拆成两三步小提示词依次下发。知其所以然BlenderMCP 的三方结构整条链路长这样AI 客户端 ←MCP 协议→ MCP 服务端 ←TCP 9876 端口→ Blender 插件中间跑的是 JSON 消息。addon.py跑在 Blender 内部既是监听 9876 端口的 socket 服务端也是你看到的那个 N 面板。收到指令后在这里执行真实的 Blender 操作。src/blender_mcp/server.pyMCP 服务端对外暴露get_scene_info、get_viewport_screenshot、execute_blender_code等工具并负责与 addon 的 socket 通信。main.py 与 pyproject.toml包入口和打包配置你配置里的uvx blender-mcp命令就定义在pyproject.toml的 scripts 段。src/blender_mcp/config.py遥测匿名使用统计的后端配置全部支持环境变量覆盖配套的telemetry.py、secret_store.py、secret_redact.py分别负责统计上报、API Key 加密存储和敏感信息脱敏。进阶与扩展改源码从这 4 个入口下手 想动手改的读者记住这几个文件就够了加工具在 server.py 里加一个 MCP 工具函数再到 addon.py 里补对应的命令处理两端各改一处。换地址MCP 服务跑在远程机器、Docker 或 WSL 里时用环境变量BLENDER_HOST/BLENDER_PORT指定 Blender 实际监听的地址和端口默认 localhost:9876。关遥测在客户端配置的env里加BLENDER_MCP_DISABLE_TELEMETRYtrue一行命令即可完全停用统计。接外部资产服务Sketchfab、Hyper3D、Hunyuan3D 的 API Key 存在 Blender 插件偏好里Edit Preferences Add-ons Blender MCP重启不丢不用每次写环境变量。避坑指南安装与连接最常见的 4 个卡点现象客户端报spawn uvx ENOENT。原因图形界面程序不会继承你终端里的 PATH找不到uvx。解法终端执行which uvxWindows 用where uvx拿到完整路径直接填进配置的command字段Windows 上可把command设为cmd、args设为/c uvx blender-mcp。现象点了 Connect第一条指令没反应或报错。原因MCP 服务是客户端首次调用时才启动的首次握手容易没跟上另外 Blender 必须以正常 GUI 方式运行blender -b后台模式下 socket 和视口工具都不可用。解法确认插件面板显示已连接然后把同一条指令重发一次不要手动去终端跑uvx启动交给客户端。现象Apple SiliconM1~M4机器上装依赖报 cryptography 构建失败提示在为 x86_64 编译。原因uvx默认选了与 Mac 架构不匹配的 Python。解法在配置的args里加上--python 3.11-aarch64强制使用 arm64 版 Python。现象一长串复杂操作走到一半超时。原因单条指令内部要执行的 Blender 操作太多超过 socket 的等待上限。解法把需求拆成 2~3 条连续的短句提示词逐条下发边看视口边确认。最后提醒一句安全边界execute_blender_code工具会在 Blender 里执行任意 Python用之前先 CtrlS 存好工程避免一次失误毁掉未保存的场景。动手之前两个延伸阅读装好之后从让 AI 复刻一张参考图开始练手是熟悉整套工作流最快的方式。协议细节和许可条款见 LICENSE 与 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），仅供参考