BlenderMCP3步让AI直接在Blender里建模新手完整实操指南【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcpBlenderMCP 是一个让 AI 接管 Blender 3D 建模的开源工具你用自然语言说需求它在 Blender 里替你创建物体、改材质、下载资产、摆好灯光。无论你是刚装好 Blender 的新手还是不想写脚本的老手 3D 艺术家都能通过对话完成场景搭建。 先说清楚它能替你干哪些活别被MCP协议这些词吓到你只需要知道它能做什么。按日常使用频率排一下直接操纵物体——在场景里加一个球体放大两倍移到左边。创建、移动、缩放、删除都能一句话完成。控制材质——把这辆车改成红色金属质感它会定位对象并修改材质参数。看懂场景——它可以读取当前场景里所有对象、灯光、相机的信息还能截图返回 Blender 视口画面。也就是说AI 不只是盲操作它能看见自己做了什么再决定下一步。执行 Python 代码——execute_blender_code工具允许 AI 在 Blender 里直接跑任意 Python 脚本处理工具集覆盖不到的情况。接入外部资源库——Poly HavenHDRI、纹理、模型、Sketchfab搜索导入模型、Hyper3D Rodin 和 Hunyuan3DAI 生成 3D 模型四家都内置了。它是怎么实现的两个文件、一个端口addon.py装在 Blender 里的插件在本机开一个 socket 服务器默认 9876 端口接收 JSON 指令并在 Blender 主线程执行。src/blender_mcp/server.pyMCP 服务器对上接入你的 AI 客户端对下连接 Blender 插件。链路是AI 客户端 ←MCP 协议→ server.py ←TCP 9876JSON→ addon.py。理解了这条链路后面所有配置和排错就都通了。 环境准备装之前先核对 3 样东西依赖最低要求Blender3.0推荐 4.x / 5.x且要用正常 GUI 启动不能用blender -b后台模式Python3.10uv 包管理器最新版1️⃣ 装 uv三选一macOSbrew install uv—— 用 Homebrew 安装 uvWindowspowershell -c irm https://astral.sh/uv/install.ps1 | iex—— 从官方脚本一键安装Linuxcurl -LsSf https://astral.sh/uv/install.sh | sh—— 下载并执行官方安装脚本注意不要用pip install uv它装出来的环境可能没有uvx命令后面客户端会找不到。Windows 装完后记得把%USERPROFILE%\.local\bin加进用户 PATH然后重启你的 AI 客户端。2️⃣ 拿到代码并装插件git clone https://gitcode.com/GitHub_Trending/bl/blender-mcp这条命令把整个仓库拉到本地我们只需要里面的addon.py。然后在 Blender 里编辑 → 偏好设置 → 插件 → 安装选克隆目录里的addon.py启用Interface: Blender MCP。装好后你不需要额外启动任何东西插件会在点连接时才起服务。3️⃣ 在 AI 客户端注册 MCP 服务器以 Claude Desktop 为例设置 → 开发者 → 编辑配置在claude_desktop_config.json里加上{ mcpServers: { blender: { command: uvx, args: [blender-mcp] } } }这段配置告诉客户端要用uvx按需拉起blender-mcp这个服务器。Cursor、VS Code、OpenCode 都是同样的 JSON 结构Windows 下把 command 写成cmd、args 写成[/c, uvx, blender-mcp]。Claude Code CLI 则是一行命令claude mcp add blender uvx blender-mcp。改完配置后完全退出客户端再重开——GUI 程序不会继承你终端的环境变量这一步漏了是报错重灾区。 第一次跑通3步建立连接在 Blender 里按N打开 3D 视图侧边栏已经可见就跳过切到BlenderMCP标签页。按需勾选 Poly Haven 等资源库开关不打算用 AI 下载资产就全不勾。点击Connect to Claude按钮。连接成功后AI 客户端里会出现一个锤子小图标表示 Blender 工具已激活。这时先别急着下大任务发一句测试指令列出当前场景里所有物体。它会调get_scene_info把场景内容报给你——如果收到了物体清单链路就通了。提示第一条指令偶发失败直接重试一次即可这是已知现象。 实战6 条可以直接抄的提示词跑通之后按先小后大的节奏试创建一个低多边形地牢里面有条龙守着一罐黄金 —— 一次生成完整场景用 Poly Haven 的 HDRI、岩石和植被模型做一个海滩 —— 自动下载并摆放资产把这张参考图还原成 Blender 场景附上图片—— 参考图转 3D用 Hyper3D 生成一个花园侏儒 —— AI 生成模型再导入场景把这辆车改成红色金属 —— 精准材质调整打一套摄影棚灯光摆个等轴测相机 —— 灯光与镜头一步到位复杂需求别一句话全塞给它。像海滩场景这种可以拆成先放 HDRI → 再下岩石 → 最后加植被三步每步之间 AI 都能看截图自查成功率明显更高。⚙️ 进阶配置最容易漏掉的那几个开关远程主机 / Docker / WSL改两个环境变量MCP 服务器和 Blender 不在同一台机器时在客户端配置的env里指定env: { BLENDER_HOST: host.docker.internal, BLENDER_PORT: 9876 }BLENDER_HOST告诉服务器去哪里找 Blender默认 localhostBLENDER_PORT是端口。Docker 里用host.docker.internal指向宿主机WSL2 里访问 Windows 上的 Blender试试127.0.0.1或宿主机的局域网 IP。客户端找不到 uvxspawn uvx ENOENT在终端执行which uvxmacOS/Linux或where uvxWindows拿到完整路径把它填进配置的command字段。另一类变体M1/M2/M3/M4 的 Mac 上uvx误用 x86 解释器在 args 里加--python 3.11-aarch64强制 arm64。三个资源库需要各自的密钥密钥存在编辑 → 偏好设置 → 插件 → Blender MCP里重启 Blender 后依然有效SketchfabBLENDERMCP_SKETCHFAB_API_KEYHyper3DBLENDERMCP_HYPER3D_API_KEY有免费额度按日限流Hunyuan3DBLENDERMCP_HUNYUAN3D_SECRET_ID/SECRET_KEY/API_URL彻底关闭遥测项目默认会上报匿名的工具调用统计。不想上报的话在配置的env里加BLENDER_MCP_DISABLE_TELEMETRY: true或在 Blender 插件偏好里取消遥测勾选项。 连不上时按这个顺序排查Blender 侧确认侧边栏里插件服务器显示为运行中确认 Blender 是 GUI 模式启动的。客户端侧确认你没有手动在终端跑uvx——服务器由客户端自己拉起手动跑反而冲突。命令找不到回到which uvx/where uvx用完整路径替换配置里的uvx。Python 冲突配置里加args: [--python, 3.11, blender-mcp]并设env: {UV_PYTHON_PREFERENCE: only-managed}还报错就执行uv cache clean blender-mcp uvx --refresh blender-mcp清缓存强刷。超时报错90% 是任务太大。把请求拆成连续的小步骤。以上都试过重启 AI 客户端和 Blender 插件服务器多数玄学问题到此结束。⚠️ 上手前必须知道的 3 件事execute_blender_code能跑任意 Python 代码。它功能强大意味着 AI 也能误伤你的场景。习惯每次让它执行代码前先保存文件。资源库下载是显式开关。Poly Haven 的 HDRI、纹理、模型都只在你勾选对应选项后才可用不需要就在侧边栏关掉省流量也省误触。复杂操作要拆步。一条指令里塞太多动作容易超时先做 A确认后再做 B的对话方式比一次性下达更稳。装好之后你的工作流就变成描述需求 → AI 看场景 → 动手改 → 再截图自查。剩下的事交给多轮对话慢慢把场景磨到位。【免费下载链接】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里建模，新手完整实操指南
BlenderMCP3步让AI直接在Blender里建模新手完整实操指南【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcpBlenderMCP 是一个让 AI 接管 Blender 3D 建模的开源工具你用自然语言说需求它在 Blender 里替你创建物体、改材质、下载资产、摆好灯光。无论你是刚装好 Blender 的新手还是不想写脚本的老手 3D 艺术家都能通过对话完成场景搭建。 先说清楚它能替你干哪些活别被MCP协议这些词吓到你只需要知道它能做什么。按日常使用频率排一下直接操纵物体——在场景里加一个球体放大两倍移到左边。创建、移动、缩放、删除都能一句话完成。控制材质——把这辆车改成红色金属质感它会定位对象并修改材质参数。看懂场景——它可以读取当前场景里所有对象、灯光、相机的信息还能截图返回 Blender 视口画面。也就是说AI 不只是盲操作它能看见自己做了什么再决定下一步。执行 Python 代码——execute_blender_code工具允许 AI 在 Blender 里直接跑任意 Python 脚本处理工具集覆盖不到的情况。接入外部资源库——Poly HavenHDRI、纹理、模型、Sketchfab搜索导入模型、Hyper3D Rodin 和 Hunyuan3DAI 生成 3D 模型四家都内置了。它是怎么实现的两个文件、一个端口addon.py装在 Blender 里的插件在本机开一个 socket 服务器默认 9876 端口接收 JSON 指令并在 Blender 主线程执行。src/blender_mcp/server.pyMCP 服务器对上接入你的 AI 客户端对下连接 Blender 插件。链路是AI 客户端 ←MCP 协议→ server.py ←TCP 9876JSON→ addon.py。理解了这条链路后面所有配置和排错就都通了。 环境准备装之前先核对 3 样东西依赖最低要求Blender3.0推荐 4.x / 5.x且要用正常 GUI 启动不能用blender -b后台模式Python3.10uv 包管理器最新版1️⃣ 装 uv三选一macOSbrew install uv—— 用 Homebrew 安装 uvWindowspowershell -c irm https://astral.sh/uv/install.ps1 | iex—— 从官方脚本一键安装Linuxcurl -LsSf https://astral.sh/uv/install.sh | sh—— 下载并执行官方安装脚本注意不要用pip install uv它装出来的环境可能没有uvx命令后面客户端会找不到。Windows 装完后记得把%USERPROFILE%\.local\bin加进用户 PATH然后重启你的 AI 客户端。2️⃣ 拿到代码并装插件git clone https://gitcode.com/GitHub_Trending/bl/blender-mcp这条命令把整个仓库拉到本地我们只需要里面的addon.py。然后在 Blender 里编辑 → 偏好设置 → 插件 → 安装选克隆目录里的addon.py启用Interface: Blender MCP。装好后你不需要额外启动任何东西插件会在点连接时才起服务。3️⃣ 在 AI 客户端注册 MCP 服务器以 Claude Desktop 为例设置 → 开发者 → 编辑配置在claude_desktop_config.json里加上{ mcpServers: { blender: { command: uvx, args: [blender-mcp] } } }这段配置告诉客户端要用uvx按需拉起blender-mcp这个服务器。Cursor、VS Code、OpenCode 都是同样的 JSON 结构Windows 下把 command 写成cmd、args 写成[/c, uvx, blender-mcp]。Claude Code CLI 则是一行命令claude mcp add blender uvx blender-mcp。改完配置后完全退出客户端再重开——GUI 程序不会继承你终端的环境变量这一步漏了是报错重灾区。 第一次跑通3步建立连接在 Blender 里按N打开 3D 视图侧边栏已经可见就跳过切到BlenderMCP标签页。按需勾选 Poly Haven 等资源库开关不打算用 AI 下载资产就全不勾。点击Connect to Claude按钮。连接成功后AI 客户端里会出现一个锤子小图标表示 Blender 工具已激活。这时先别急着下大任务发一句测试指令列出当前场景里所有物体。它会调get_scene_info把场景内容报给你——如果收到了物体清单链路就通了。提示第一条指令偶发失败直接重试一次即可这是已知现象。 实战6 条可以直接抄的提示词跑通之后按先小后大的节奏试创建一个低多边形地牢里面有条龙守着一罐黄金 —— 一次生成完整场景用 Poly Haven 的 HDRI、岩石和植被模型做一个海滩 —— 自动下载并摆放资产把这张参考图还原成 Blender 场景附上图片—— 参考图转 3D用 Hyper3D 生成一个花园侏儒 —— AI 生成模型再导入场景把这辆车改成红色金属 —— 精准材质调整打一套摄影棚灯光摆个等轴测相机 —— 灯光与镜头一步到位复杂需求别一句话全塞给它。像海滩场景这种可以拆成先放 HDRI → 再下岩石 → 最后加植被三步每步之间 AI 都能看截图自查成功率明显更高。⚙️ 进阶配置最容易漏掉的那几个开关远程主机 / Docker / WSL改两个环境变量MCP 服务器和 Blender 不在同一台机器时在客户端配置的env里指定env: { BLENDER_HOST: host.docker.internal, BLENDER_PORT: 9876 }BLENDER_HOST告诉服务器去哪里找 Blender默认 localhostBLENDER_PORT是端口。Docker 里用host.docker.internal指向宿主机WSL2 里访问 Windows 上的 Blender试试127.0.0.1或宿主机的局域网 IP。客户端找不到 uvxspawn uvx ENOENT在终端执行which uvxmacOS/Linux或where uvxWindows拿到完整路径把它填进配置的command字段。另一类变体M1/M2/M3/M4 的 Mac 上uvx误用 x86 解释器在 args 里加--python 3.11-aarch64强制 arm64。三个资源库需要各自的密钥密钥存在编辑 → 偏好设置 → 插件 → Blender MCP里重启 Blender 后依然有效SketchfabBLENDERMCP_SKETCHFAB_API_KEYHyper3DBLENDERMCP_HYPER3D_API_KEY有免费额度按日限流Hunyuan3DBLENDERMCP_HUNYUAN3D_SECRET_ID/SECRET_KEY/API_URL彻底关闭遥测项目默认会上报匿名的工具调用统计。不想上报的话在配置的env里加BLENDER_MCP_DISABLE_TELEMETRY: true或在 Blender 插件偏好里取消遥测勾选项。 连不上时按这个顺序排查Blender 侧确认侧边栏里插件服务器显示为运行中确认 Blender 是 GUI 模式启动的。客户端侧确认你没有手动在终端跑uvx——服务器由客户端自己拉起手动跑反而冲突。命令找不到回到which uvx/where uvx用完整路径替换配置里的uvx。Python 冲突配置里加args: [--python, 3.11, blender-mcp]并设env: {UV_PYTHON_PREFERENCE: only-managed}还报错就执行uv cache clean blender-mcp uvx --refresh blender-mcp清缓存强刷。超时报错90% 是任务太大。把请求拆成连续的小步骤。以上都试过重启 AI 客户端和 Blender 插件服务器多数玄学问题到此结束。⚠️ 上手前必须知道的 3 件事execute_blender_code能跑任意 Python 代码。它功能强大意味着 AI 也能误伤你的场景。习惯每次让它执行代码前先保存文件。资源库下载是显式开关。Poly Haven 的 HDRI、纹理、模型都只在你勾选对应选项后才可用不需要就在侧边栏关掉省流量也省误触。复杂操作要拆步。一条指令里塞太多动作容易超时先做 A确认后再做 B的对话方式比一次性下达更稳。装好之后你的工作流就变成描述需求 → AI 看场景 → 动手改 → 再截图自查。剩下的事交给多轮对话慢慢把场景磨到位。【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考