BlenderMCP 新手指南:3步装好插件,一句话让Claude替你建模
【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcp
给实习医生做一张心脏结构图,或在课上放一段脊柱动画,过去你都得在 Blender 里手搓一下午。BlenderMCP 把这条路缩短了:它是把 Blender 接入任意大语言模型(LLM,如 Claude)的社区插件,装好后你只需在聊天框敲一句中文,它就能替你创建、调整、打光整个 3D 场景,适合医学教育、内容创作和 3D 新手。
它替你干了哪些活
链路不长:LLM 客户端 ↔ MCP 服务器(src/blender_mcp/server.py)↔ TCP 9876 端口 ↔ Blender 里的 addon.py。你发一句话,Claude 先用get_scene_info看一眼场景里有什么对象、灯光和相机,再下发创建、移动、缩放指令,干完还能用get_viewport_screenshot给视口拍张照自查。
它覆盖的能力包括:建对象、改材质、查场景状态、从 Poly Haven 下 HDRI 和贴图、在 Sketchfab 搜模型并导入、用 Hyper3D Rodin 或 Hunyuan3D 按文字生成 3D 资产。想抠细节,直接翻插件主文件和服务器源码。
三步跑通:装好插件连上 AI
环境要求:Blender 3.0+(推荐 4.x)、Python 3.10+、uv(一个快速的 Python 包管理器,自带uvx命令)。
第①步 装 uv。macOS 在终端执行brew install uv;Windows 执行:
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"装完记得把用户目录下的.local\bin加进 PATH。
第②步 装插件。打开仓库里的addon.py,Blender 里走 编辑 → 偏好设置 → 插件 → 安装…,选中该文件,勾上 "Interface: Blender MCP"。
第③步 接客户端。Claude Desktop 打开 Settings → Developer → Edit Config,往claude_desktop_config.json加:
{ "mcpServers": { "blender": { "command": "uvx", "args": ["blender-mcp"] } } }改完彻底退出客户端重启。Blender 的 3D 视图按N打开侧边栏,切到 BlenderMCP 选项卡(想下素材就勾上 Poly Haven),点Connect to Claude。对话里出现锤子图标,说明工具已激活,可以开工。
一句话出效果:三个场景直接抄
心脏结构图:「建一个低多边形心脏模型,四个腔室拆成独立对象,各套半透明红色材质,再打三点影棚光,相机设等距视角。」完成后追问「截个视口图看看效果」,它会自己截图、自己改。
耳内听小骨🦴:锤骨、砧骨、镫骨这种手搓费劲的小结构,交给 Hyper3D:「用 Hyper3D 生成一套听小骨模型,放到中耳腔位置,按场景比例缩放。」
脊柱 + 贴图:「在 Sketchfab 搜解剖学脊柱模型,把可下载的最佳一款导入场景;再从 Poly Haven 下一张影棚 HDRI,把灯光衬得真实一点。」
提醒一句:工具集里包含execute_blender_code,AI 会在 Blender 里执行任意 Python,能力大、风险也大,开工前先把文件存了。
连不上或模型太卡?先查这五处 🔌
① 第一条指令失败很常见,直接重试一次即可;顺手确认侧边栏里服务器状态是已连接。
② 客户端报spawn uvx ENOENT:图形界面读不到你终端的 PATH。用which uvx(Windows 用where uvx)拿到完整路径,填进配置的command里。
③ 指令超时:别把整段要求塞进一句话,拆成多条小指令顺序执行;解剖模型这种复杂场景尤其要一块一块来。
④ Apple Silicon 报 cryptography wheel 错误:把配置里的 args 改成["--python", "3.11-aarch64", "blender-mcp"],强制 arm64 的 Python。
⑤ Blender 跑在 WSL/Docker 里:配置里加"env": {"BLENDER_HOST": "host.docker.internal", "BLENDER_PORT": "9876"};WSL2 直连 Windows 宿主可以试试127.0.0.1。
大场景卡顿时,让 Claude 开视口简化或先建低模代理,正式展示再切回高精度版本。
装完后找个空场景试一句「在桌上放一杯咖啡」,一分钟内出活就说明你的 BlenderMCP AI 建模工作流通了。远程主机与 API 密钥等进阶配置见 README.md,想看懂每条指令的去向,翻 src/blender_mcp/server.py。
【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcp
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考