用一句文字在 Blender 里生成 3D 模型和 PBR 材质：BlenderMCP 完整教程

用一句文字在 Blender 里生成 3D 模型和 PBR 材质BlenderMCP 完整教程【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcpBlenderMCP 通过模型上下文协议MCP把 Blender 3D 接入任意大语言模型让你直接在对话里用文字完成建模、调材质、看场景截图这些原本要逐菜单点的操作。整条链路只有两半装在 Blender 里的插件负责接收并执行指令MCP 服务器负责把你的 AI 客户端比如 Claude Desktop和插件连起来。下面以做一间带龙守金堆的中世纪地牢再给它铺上真实感材质这个任务为主线走完整个流程。装好 uv让服务器能被一键拉起BlenderMCP 的服务器端是一个 Python 包通常用uvx命令临时运行不需要手动pip install。先确认三件事依赖最低要求说明Blender3.0需要正常 GUI 窗口blender -b后台模式跑不了插件的 socketPython3.10服务器侧使用uv最新版推荐用官方脚本安装pip install uv可能不会生成uvx各平台安装 uv# macOS brew install uv # Linux curl -LsSf https://astral.sh/uv/install.sh | shWindows 则在 PowerShell 里跑powershell -c irm https://astral.sh/uv/install.ps1 | iex并把~/.local/bin加进 PATH。装好后可以用BLENDER_HOST和BLENDER_PORT环境变量调整监听地址默认localhost:9876一般不用动。安装插件把 Blender 接到 Claude 上这一步在 addon.py 和 Claude 配置文件之间切换从项目仓库拿到addon.py在 Blender 里走Edit → Preferences → Add-ons → Install选中文件启用 Interface: Blender MCP。打开 Claude 桌面端的Settings → Developer → Edit Config把 MCP 服务器加进去{ mcpServers: { blender: { command: uvx, args: [blender-mcp] } } }改完配置后完全退出并重启客户端。回到 Blender按N打开 3D 视图侧边栏切到BlenderMCP标签页点Connect to Claude。连上之后连接是双向的插件在 Blender 内开一个 TCP socket 服务MCP 服务器侧的 server.py 把每条 AI 指令转成 JSON 发过去执行结果再原路返回。所以服务器其实一直是由 Claude 客户端帮你启动的不需要你手动跑uvx。第一条文字指令能做出什么连上后直接输入一句话试试Create a low poly dungeon with a dragon guarding gold做一个低多边形地牢一条龙守着一堆金币AI 会自己拆成若干步建房间、摆模型、调材质、放相机。除了直接建东西这套工具还内置了几个实用能力值得知道场景检查可以问现在场景里有什么它会列出所有对象、灯光、相机相当于替你看了一遍大纲视图。视口截图AI 能拿到 Blender 视口的实时画面所以你可以说把相机转到侧面再看一次它是在看着结果改的不是盲调。执行代码复杂操作可以直接让它在 Blender 里跑一段 Python。注意这条通道能执行任意代码用之前先存盘。后续指令可以更具体比如给龙加一圈金属质感的鳞片金属度 0.8粗糙度 0.3、把金币堆换成 Sketchfab 上的现成模型——指令越具体返工越少。从 Poly Haven 给场景拉 PBR 材质光有模型还不够下一步是把真实感材质铺上去。在侧边栏的 BlenderMCP 面板里勾选Poly HavenAI 就多了一组资产工具搜索 HDRI、纹理和模型按分辨率下载再自动绑到指定对象上。你可以直接说给石墙找一个 Poly Haven 的粗糙石材纹理。底层走的是 server.py 里的search_polyhaven_assets和download_polyhaven_asset两个工具真正贴图的是插件侧的set_texture逻辑它会按用途处理每张通道图——albedo 这类颜色图设为 sRGB法线、粗糙度这类数据图设为 Non-Color并把图片打包进 .blend 文件避免丢路径。另外三个资源开关按需打开集成用途凭证存放Poly HavenHDRI / 纹理 / 模型无需密钥Hyper3D Rodin用文字生成 3D 模型有免费额度插件偏好里填 API KeySketchfab搜索并导入现成模型API KeyHunyuan3D文字/图片生成 3D 模型在偏好里配置密钥建议存在Edit → Preferences → Add-ons → Blender MCP的偏好面板里重启不丢也可以改用BLENDERMCP_SKETCHFAB_API_KEY这类环境变量注入。BlenderMCP 连不上或超时往哪里查按出现频率从高到低排现象常见原因处理第一条指令报错连接刚建立偶发失败直接重试一次即可spawn uvx ENOENTGUI 客户端读不到终端的 PATH用which uvxWindows 用where uvx拿到完整路径填进配置的command指令长时间无响应一次要求做太多事把大任务拆成几条连续的短句Apple Silicon 上 cryptography 编译报错架构不匹配配置里改为args: [--python, 3.11-aarch64, blender-mcp]WSL / Docker 里连不到宿主地址不对在配置env里设BLENDER_HOST如host.docker.internal改完任何配置记得重启 AI 客户端和 Blender 里的服务器再试。如果确认连上了Claude 侧会显示一个小锤子图标表示 Blender 工具已激活。想让结果更可控还有两个习惯生成前先想清楚尺寸和结构比如房间 10m×8m拱顶出图不满意时先让 AI 截图看看现状再针对截图提修改意见比反复重掷随机结果稳定得多。接下来可以往哪走想深入实现细节先看 server.py所有 MCP 工具的定义和参数都在这一个文件里想改插件行为比如新增指令、调整贴图逻辑对应的是 addon.py仓库根目录的 test_set_texture_version_guard.py 示范了如何在不启动 Blender 的情况下对插件代码做静态校验。项目采用 MIT 许可见 LICENSE欢迎通过提 issue 或 PR 的方式参与fork 后建分支、提交改动即可。先打开 Blender 和 Claude把第一条地牢指令发出去看看它给出的第一版场景长什么样。【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考