BlenderMCP 安装与实战教程如何 5 步让 Blender 听懂自然语言建模指令【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcp想让 Blender 场景里多出几个物体、调个灯光、换套材质通常得在菜单和面板间来回点。装好 BlenderMCP 之后你只需在 AI 对话框里打一句在场景中央放一个木纹方块加一盏左上方的柔光几秒后 Blender 里就会出现对应结果。BlenderMCP 是一个社区插件它通过模型上下文协议Model Context Protocol一种让 AI 调用外部工具的通信协议把 Blender 接到 Claude 等任意大模型上实现用自然语言直接驱动 3D 建模。项目定位与工作机制三层结构整个链路分三层数据流是单向透明的AI 客户端 -- MCP 协议 -- MCP 服务器(src/blender_mcp/server.py) -- TCP:9876 -- Blender 插件(addon.py)AI 客户端Claude Desktop、Cursor、VS Code 等发起对话MCP 服务器端负责把 AI 意图翻译成 JSON 指令源码在 src/blender_mcp/server.pyBlender 侧插件 addon.py 在本地 9876 端口监听收到指令后在 Blender 内部执行并把结果 JSON 回传由此带来三个核心优势 双向通信AI 不光能下指令还能用get_scene_info读回场景里的物体、灯光、相机状态甚至用get_viewport_screenshot看到视口画面 指令直达 Python复杂操作最终走execute_blender_code在 Blender 内执行 Python能力上限和手写脚本一致 内置资源与生成集成Poly Haven 材质库、Sketchfab 模型库、Hyper3D/Hunyuan3D 的 AI 生成都已接通准备清单版本要求与 uv 安装命令速查依赖最低版本Blender3.0推荐 4.x/5.x需用图形界面启动不能用后台模式Python3.10见 pyproject.toml 中requires-pythonuv最新版uv 是一个 Python 包管理器uvx是它免安装直接跑工具的命令。按平台安装# macOS brew install uv # Windows powershell -c irm https://astral.sh/uv/install.ps1 | iex # Linux curl -LsSf https://astral.sh/uv/install.sh | sh注意不要用pip install uv那样可能生成不了uvx命令。最小可运行路径5 步接通 Claude获取代码git clone https://gitcode.com/GitHub_Trending/bl/blender-mcp把 addon.py 装进 Blender菜单编辑 偏好设置 插件 安装…选中addon.py然后启用Interface: Blender MCP。配置 AI 客户端。以 Claude Desktop 为例进入 Settings Developer Edit Config往claude_desktop_config.json加一段Windows 上command写cmdargs写[/c, uvx, blender-mcp]{ mcpServers: { blender: { command: uvx, args: [blender-mcp] } } }完全退出并重启客户端。图形界面程序不继承终端的 PATH重启后才会找到uvx。在 Blender 里按N打开 3D 视图侧边栏切到BlenderMCP选项卡点Connect to Claude验证动作在对话框里问当前场景里有几个物体分别叫什么名字。AI 能逐个列出物体说明链路通了首条指令偶尔会失败一次重试即可。从文本到成果一条好指令的写法跑通之后效果好不好主要取决于指令本身。一条可靠的建模指令一般包含四部分做什么目标物体或场景 几何特征低多边形街角圆柱形路灯什么样子材质、颜色、透明度场景氛围光源方向、相机机位、环境验收标准要求 AI 完成后自检查证截图确认效果三条示例指令在场景里搭一个低多边形街角一条主路、一盏路灯、两间小店用暖色平行光模拟清晨影子要柔和把场景里所有灯光顺时针旋转 30 度材质改成哑光然后列出改动前后的物体和材质清单对当前视口截图告诉我构图里哪个物体被遮挡了并给出移动建议机制说明这些句子不会原样进 Blender。AI 先调get_scene_info或get_viewport_screenshot感知现状再把操作翻译成 Python 片段经 9876 端口发给addon.py执行收到结果 JSON 后才回复你。所以指令里附带验收要求本质上是给 AI 多一次读回场景的机会闭环更稳。能力扩展资源库与 AI 生成接入Poly HavenHDRI、贴图、模型库HDRI 是高动态范围图片可当场景环境光用。先在 BlenderMCP 侧边栏勾选启用然后发指令从 Poly Haven 找一张森林 HDRI 设为环境光曝光调到高光不过曝。对应实现是src/blender_mcp/server.py里的download_polyhaven_asset。Sketchfab 模型库需在偏好设置里填 API Key一串访问凭证。示例在 Sketchfab 搜索 vintage car导入第一个结果到场景并应用红色金属材质走search_sketchfab_models和download_sketchfab_model。AI 模型生成Hyper3D Rodin / Hunyuan3D免费额度有每日上限可配置自己的 Key。示例用 Hyper3D 生成一个花园侏儒模型放到场景中央高度 1.2 米。避坑与性能连接失败与超时自查清单连接类客户端报spawn uvx ENOENT终端跑which uvxWindows 用where uvx拿到完整路径填进配置里的command连不上确认侧边栏里 Connect 处于运行状态不要手动在终端敲uvx服务器由客户端负责拉起改完任何配置都要完全退出客户端再重开性能类单条指令内容太大导致超时时拆成几条小指令按顺序发Python 版本有冲突时在配置的args里固定版本[--python, 3.11, blender-mcp]收尾回顾一下装好插件、加一段客户端配置、点一次 ConnectBlender 就能开始听指令干活之后把每条指令按做什么、什么样子、什么氛围、如何验收四段来写成功率会明显更高。随着 AI 模型生成和资源库覆盖面的扩大完全靠指令搭完一个场景的比例还会继续增加。想动手的话回到最小可运行路径一节从上面的 clone 地址开始即可更多细节可查仓库内的 README.md。【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
