MCP for Blender 上手指南三步把 AI 接入 Blender一句话搭出 3D 场景【免费下载链接】mcp-for-blenderCommunity plugin to control Blender 3D with any LLM of your choice. Not affiliated with the official Blender Foundation.项目地址: https://gitcode.com/GitHub_Trending/bl/mcp-for-blender会写“把沙发改成红色金属”这种话就能让 AI 替你操作 Blender 3D。MCP for Blender 是一个开源社区插件MIT 协议通过 Model Context ProtocolMCP可理解为 AI 客户端与外部工具之间的通信协议把 Claude Desktop、Cursor、VS Code 等 AI 助手和 Blender 连起来。你描述效果它生成并执行 Blender Python 代码再实时回看视口、把结果反馈给 AI 继续修正。本文覆盖安装、配置与常见报错按最小验证路径走一遍十分钟即可确认整条链路。痛点从“要一张红色金属桌子”到成图中间隔着什么设想这样一个需求地面上放一张 2x1 米的桌子配两把椅子再打一套暖色三点布光。没有 AI 时它意味着三块机械劳动自己翻 bpy 文档、在节点编辑器里拖线试参数、反复摆场景改相机的重复搭建。MCP for Blender 把分工切得很干净它只干“体力活”你负责用一句大白话说明要什么效果它负责生成 bpy 代码、创建并对齐对象、调整材质与灯光还会自己看视口确认结果是否符合描述它明确不做创意决策。风格取舍、画面“好不好看”仍然由你拍板。两个边界也先说清楚这是第三方项目与 Blender 官方基金会无关另外 AI 会在你的 Blender 里真实执行 Python 代码动手前先存一次档是硬性习惯。安装前检查版本门槛与依赖清单硬门槛只有一个外加两个依赖依赖门槛说明Blender3.04.x / 5.x 更稳Python3.10供 MCP 服务端运行uvPython 包管理器必装提供uvx命令macOS 执行brew install uv即可Linux 与 Windows 的安装方式见 README.md 的 Installation 一节还有两条前置小提醒uv 要用官方安装脚本装别用pip install uv否则可能没有uvx命令不想走 uv 路线的话pipx install blender-mcp同样可行。Blender MCP 接入流程客户端登记、插件启用、链路验证全程三个动作一个在 AI 端一个在 Blender 端一个用来验证两端。第一步把 uvx 服务端登记到 AI 客户端以 Claude Desktop 为例Settings → Developer → Edit Config在配置文件中加入这段{ mcpServers: { blender: { command: uvx, args: [blender-mcp] } } } PyPI 包名现已更名为mcp-for-blender旧名blender-mcp照常可用已有配置无需改动。这里有个关键认知不要手动在终端跑uvx。MCP 服务器由 AI 客户端按需拉起自己先跑一遍反而是常见的故障源。第二步安装并启用 Blender 插件从仓库下载 addon.py然后在 Blender 里Edit → Preferences → Add-ons → Install选中该文件勾选启用 “Interface: Blender MCP”新版界面中显示为 “Interface: MCP for Blender”。第三步侧边栏启动服务验证链路在 3D View 中按N打开侧边栏切到插件标签页点击Connect to Claude部分版本显示为Start MCP Server插件在 Blender 打开时也会自动启动服务。回到 AI 客户端看到锤子图标出现即代表 Blender 工具组已激活链路打通。接通之后能干什么三个“你说→它做”实例高频能力可以归成四类规律一致你说 → 它做。你说它做“现在场景里都有什么”列出全部对象的名称、位置、旋转、缩放外加相机与灯光参数不必逐个点开大纲树“在地面上放一张 2x1 米的桌子配两把椅子”创建几何体、对齐位置、命名对象一次做完“把车改成红色金属漆加三点布光”生成金属着色器节点调粗糙度与反射率顺手配好相机焦距和传感器参数资源与生成是另一块大头说“下个暖色 HDRI 环境”它走 Poly Haven 下载说“生成一个小花园侏儒”它调 Hyper3D Rodin 出模型。各类 API Key 都存放在插件偏好里重启 Blender 不会丢。从一句提示词到成图AI 的自检闭环拿最经典的例子练手“创建一个现代风格的客厅一张沙发、一个落地灯暖色灯光。”幕后过程是这样的AI 先在 Blender 里执行一段 Python把沙发、落地灯和地板搭出来接着调用截屏工具查看当前视口灯光偏暗它自己调整强度再截一张对比循环往复直到画面确实称得上“暖色”。你全程不用打开 Python 控制台最后保存 .blend 文件即可。迭代成本同样低接着补一句“沙发换成皮质加一盏落地窗”它是在现有场景上修改而不是推倒重建。想追实现细节核心代码在 src/blender_mcp/服务端入口是 server.py。Blender MCP 常见报错与排障速查遇到问题先对照下表顺序是“现象 → 先查什么”现象先检查什么连不上AI 客户端里没有锤子图标先到 Blender 侧边栏确认是否点了 Connect服务器应由 AI 客户端拉起别手动执行uvx报spawn uvx ENOENT终端执行which uvx找到它的完整路径再把这个路径填进配置的command字段第一条命令失败或超时首条命令经常失手直接重试一次大任务拆成几段小提示词分步发送装完 uv 却找不到uvx多半是用了pip install uv换回官方安装脚本macOS 即brew install uv⚠️ 再记两条边界事项execute_blender_code会真实执行 Python让它碰正式场景之前先保存一份 .blendApple Silicon 上遇到 cryptography 架构报错在配置的args里加--python, 3.11-aarch64。十分钟验证链路最小验证路径与进阶方向不想一上来就奔大任务就先发最小提示词“放一张桌子到场景里。”视口里桌子出现、客户端里锤子图标在线整条链路就算通了通常十分钟以内。✅中途卡住时优先翻 README.md 的 Troubleshooting 一节提示词写法上一次只做“摆一个物体 / 改一种材质”这种粒度比一口气丢整段需求更稳。这套工具的价值在于补上“知道要什么效果”与“会写对应 Blender 代码”之间的断层——创意判断仍归你布光、摆场景、改相机这类机械活交给 AI。链路验证之后可以逐步过渡到材质调参、灯光布光和资源生成等更复杂的玩法。【免费下载链接】mcp-for-blenderCommunity plugin to control Blender 3D with any LLM of your choice. Not affiliated with the official Blender Foundation.项目地址: https://gitcode.com/GitHub_Trending/bl/mcp-for-blender创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考