企业官网建设流程全解析

BlenderMCP 教程：3 步装好这个 Blender 插件，用自然语言控制 3D 建模

【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcp

BlenderMCP 是一个开源的 Blender 插件，基于 Model Context Protocol（MCP）让任意大语言模型直接操作 Blender 3D：你在对话里描述想建什么，AI 就会创建物体、调整材质、截取视口画面并实时改场景。本文从干净环境讲起，带你把 AI 3D 建模工作流完整跑通，最后附上新手最常踩的 5 个坑。

🤔 先说痛点：为什么 AI 建模总差最后一步

让 AI 讲建模理论很简单，难的是把它落到 Blender 里：你要么去 scripting 工作区手搓 Python，要么把"把车改成红色金属质感"人肉翻译成一串节点操作。BlenderMCP 补的就是这段距离。

它的链路很短：你的 AI 客户端（Claude Desktop、Cursor、VS Code 等）通过 MCP 协议连到一个 MCP 服务器，服务器再用 TCP 9876 端口把 JSON 指令发给 Blender 里安装的 addon，由后者真正执行创建、移动、缩放、删改等操作。而且它是双向的——Blender 能把视口截图回传给 AI，相当于让模型"看见"自己的作品并自我修正。核心桥梁实现在 src/blender_mcp/server.py。

🧩 从零上手：3 步装好 BlenderMCP

准备工作三样：Blender 3.0 以上（推荐 4.x）、Python 3.10 以上、uv 运行器。

第 1 步：装好 uv

macOS 执行brew install uv，Linux / Windows 用官方安装脚本即可。注意不要用pip install uv，那样可能生成不了uvx命令。

第 2 步：在 AI 客户端里注册 blender-mcp

以 Claude Desktop 为例，在 Settings > Developer > Edit Config 打开claude_desktop_config.json，加入：

{ "mcpServers": { "blender": { "command": "uvx", "args": ["blender-mcp"] } } }

Cursor、VS Code 的配置结构相同；如果你用 Claude Code CLI，一行claude mcp add blender uvx blender-mcp就够了。

第 3 步：装 addon 并建立连接

1. 拿到仓库里的 addon.py，也可以先克隆仓库：git clone https://gitcode.com/GitHub_Trending/bl/blender-mcp
2. Blender 中进入 Edit > Preferences > Add-ons > Install…，选中addon.py
3. 勾选启用 "Interface: Blender MCP"
4. 在 3D 视口按N打开侧边栏，切到 BlenderMCP 标签，点击 Connect

连接成功后，AI 客户端会显示一个锤子图标，表示 Blender 工具已就绪。

⚡ 连上之后能干什么：4 个真实用法

• 一句话建场景："建一个低多边形地牢，门口站一条守金币的龙"——AI 会自己规划物体、位置和材质。
• 改材质不翻菜单："把这台车改成红色金属"，直接在对话里完成。
• AI 会"看"图：视口截图工具让 AI 检查渲染结果，不对就自己再改一轮，相当于内置了质检。
• 资产与生成式建模：在侧边栏开启 Poly Haven 后可直接拉取 HDRI、贴图和模型；还能搜 Sketchfab 模型入库，或用 Hyper3D Rodin、Hunyuan3D 把文字生成 3D 资产。

另外还有一个"终极模式"：AI 可以直接在 Blender 里编写并执行任意 Python 代码，凡是 API 能做的它都能做。副作用是——用之前记得先Ctrl+S保存文件。

🛠️ 避开新手最常踩的 5 个坑

1. 报spawn uvx ENOENT：GUI 客户端不继承终端 PATH，用which uvx（Windows 用where uvx）拿到完整路径，填进配置的command字段。
2. 改完配置没生效：必须完全退出 AI 客户端再重开，热重载不算数。
3. 用了后台模式：blender -b下 MCP 套接字和视口工具都不可用，请保持正常的图形界面会话。
4. 手动跑 uvx：服务器由 AI 客户端负责拉起，你手动执行反而可能抢端口；另外第一条指令偶尔会失败，直接重试一次。
5. 复杂任务超时：把大需求拆成连续的小请求，比一次性丢一句"帮我做整套场景"稳得多。

顺带一提：Apple Silicon 上如果碰到架构不匹配，在 args 里加--python 3.11-aarch64即可。

🔒 进阶：密钥存放与隐私开关

要用 Sketchfab、Hyper3D 或 Hunyuan3D 的 API，把密钥填在 Edit > Preferences > Add-ons > Blender MCP 里，它们会持久化保存；存储走系统级加密存储（见 src/blender_mcp/secret_store.py），上传统计前会先剔除类密钥字符串（见 src/blender_mcp/secret_redact.py）。

项目默认只采集匿名使用统计（工具名、耗时、版本平台），在 src/blender_mcp/telemetry.py 里实现。想彻底关掉的话，在启动参数里加BLENDER_MCP_DISABLE_TELEMETRY=true，或在 Blender 的 addon 偏好里取消勾选。

✅ 下一步行动清单

装完可以按这个清单自检：uvx在终端能跑通 → 客户端配置里已注册 blender-mcp → addon 已启用且侧边栏点了 Connect → 客户端出现锤子图标。四步全过，就可以试着让 AI 建第一个场景了。

想继续深挖时，README.md 里有完整功能表和各客户端的接入细节，pyproject.toml 里能看到核心依赖就是 mcp 和 httpx。以后升级版本也简单：替换新addon.py，在客户端里移除并重新添加 MCP 服务器即可。

【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcp