企业官网建设流程全解析

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

晚上十一点躺床上，突然想到一个想做的3D场景，但电脑还摆在书桌上。用BlenderMCP，你在AI助手里打一句话，3D对象就会出现在电脑的Blender里，不用打开鼠标，也不用查任何参数。

它能做什么：4项上手就能用的能力

BlenderMCP是一个社区开源插件，通过模型上下文协议（MCP）把Blender接入任意大模型客户端，比如Claude Desktop或Cursor。分工很简单：你说"要什么"，AI负责在Blender里执行"怎么做"。

最常用的四项能力：

动手前自检：4个版本要求

先对照这份清单，能省掉大半排错时间：

• Blender 3.0以上，推荐4.x或5.x，且必须是正常图形界面版本，后台模式（blender -b）不可用
• Python 3.10以上
• uv包管理器。注意不要用pip install uv装，可能不会生成uvx命令
• AI客户端：Claude Desktop，或Cursor等支持MCP的客户端

🚀 首次成功的最短路径：4步连上

1. 装uv。macOS和Linux在终端执行：

# macOS brew install uv # Linux curl -LsSf https://astral.sh/uv/install.sh | sh

Windows用PowerShell跑官方一行安装脚本，然后把~\.local\bin加入PATH，完整命令见README.md。装完运行uvx --version，能打印版本号即成功。

2. 装Blender插件。从仓库下载addon.py，在Blender里打开"编辑 > 偏好设置 > 插件 > 安装…"，选中该文件，勾选"Interface: Blender MCP"。

3. 配置AI客户端。Claude Desktop路径是"设置 > 开发者 > 编辑配置"，在claude_desktop_config.json加入：

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

Cursor用户在项目根目录建.cursor/mcp.json，结构相同。配置改完要完全退出客户端再重启才生效。

4. 启动连接。在3D视口按N打开侧边栏，找到BlenderMCP选项卡，按需勾选Poly Haven，点"Connect to Claude"。客户端里出现一个锤子图标，说明连接成功：

第一次对话实战：3条指令直接抄

别一上来就搞大场景，先用这三条找感觉：

• "Create a low poly dungeon with a dragon guarding gold"——视口里直接生成一座低多边形地牢加一条看金库的龙，完整走一遍"说话→建模"的闭环。
• "Beach scene with Poly Haven HDRIs, rocks, and vegetation"——AI从Poly Haven下载HDRI环境贴图，一个海滩场景的灯光、岩石和植被一次配齐。
• "Make this car red and metallic"——场景里有辆车的话，AI先定位到它，再把材质换成红色金属，属于"改"而不是"重建"的典型用法。

进阶玩法：从AI生成3D模型到远程连接

基础跑通之后，下面几项能把边界撑开：

• 视口截图：AI能抓当前视口截图"看到"场景，你可以问"现在场景里有什么"，或让它确认效果是否符合预期。
• Hyper3D Rodin：文字描述直接生成3D模型，比如生成一个花园侏儒。免费试用有每日次数上限，申请自己的API密钥可提高限额。
• Hunyuan3D：腾讯的3D生成服务，凭据在插件偏好（编辑 > 偏好设置 > 插件 > Blender MCP）里填写，重启后仍然有效。
• Sketchfab：联网搜索现成模型并直接导入场景，不用从零建模。
• 远程主机：设置环境变量BLENDER_HOST和BLENDER_PORT，MCP服务器跑在另一台机器上，连本机的Blender，例如WSL2里驱动Windows宿主上的Blender。

🛠️ 避坑指南：7个常见卡点

1. 首条命令失败：已知现象，再发一次就行，不是配置坏了。
2. spawn uvx ENOENT：图形界面客户端不继承终端的PATH，把配置里的command换成which uvx（macOS/Linux）或where uvx（Windows）查到的完整路径。
3. 请求超时：把复杂任务拆成几条小指令依次执行，别一句话塞太满。
4. Python版本冲突：在配置里锁定版本：

"args": ["--python", "3.11", "blender-mcp"], "env": { "UV_PYTHON_PREFERENCE": "only-managed" }

5. 别手动跑uvx：服务器由客户端自动拉起，手动启动反而容易占住端口。
6. 安全：execute_blender_code会让AI在Blender里执行任意Python，能力很强的另一面是它真能改坏文件，让它跑代码前先把作品存盘，复杂操作分步下达。
7. 数据统计：默认只上报匿名使用统计（工具名、成败、耗时），提示词详情需勾选插件隐私选项才收集，类凭据字符串上传前会被剔除；彻底关闭就设BLENDER_MCP_DISABLE_TELEMETRY=true。

30秒看懂工作原理：一句话怎么变成3D对象

三方一环，链路很短：

1. 你的AI客户端和MCP服务器（src/blender_mcp/server.py）讲MCP协议，它相当于中间翻译官。
2. 服务器和Blender内的插件（addon.py）走TCP 9876端口，消息是JSON小包，例如{"type": "create_object", "params": {"type": "SPHERE"}}，Blender执行后把状态和结果回传。
3. 视口截图以base64编码返回，不依赖共享目录，所以WSL、Docker或远程服务器都能驱动本机Blender。

到这里，你的AI助手就长出了"手"，可以直接操作Blender。下一步：装好uv、下载addon.py，按上面4步完成首次连接，然后让它先建一座低多边形地牢，5分钟内你就能判断这个工具适不适合自己的工作流。

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