使用VScode+AI大模型驱动Blender建模 - 指南

本指南将帮助您在 Visual Studio Code 中配置 Blender MCP 工具，实现 AI 驱动的 3D 建模。

前置要求

• Python 3.10 或更高版本

• Blender 软件（已安装并可用）

• uv 包管理器

安装步骤

1. 安装 uv 包管理器

Windows 用户：

# 使用 pip 安装 uv
pip install uv
​
# 或者从 GitHub 下载安装
# 访问：https://github.com/astral-sh/uv

macOS 用户：

brew install uv

Linux 用户：

# 使用官方安装脚本
curl -LsSf https://astral.sh/uv/install.sh | sh

2. 安装 Blender MCP 服务器

uv pip install blender-mcp

3. 安装 Blender 插件

1. 从 Blender MCP GitHub 页面 下载 addon.py 文件

2. 打开 Blender

3. 依次点击：编辑 > 偏好设置 > 插件

4. 点击 安装 按钮，选择刚才下载的 addon.py 文件

5. 在插件列表中找到 Interface: Blender MCP，勾选启用

4. 在 Visual Studio Code 中配置 MCP 服务器

方法一：通过 Visual Studio Code 设置界面

1. 打开 Visual Studio Code

2. 按 Ctrl + ,（Windows）或 Cmd + ,（Mac）打开设置

3. 搜索 “MCP” 或 “Model Context Protocol”

4. 在 MCP 服务器配置中添加以下内容：

方法二：直接编辑 settings.json

1. 按 Ctrl + Shift + P（Windows）或 Cmd + Shift + P（Mac）打开命令面板

2. 输入 “Preferences: Open User Settings (JSON)”

3. 在配置文件中添加以下内容：

{"mcp.servers": {"blender": {"command": "uvx","args": ["blender-mcp"],"env": {}}}
}

注意：如果您的 mcp.servers 中已有其他服务器配置（如 memory），请将 blender 配置添加到现有对象中：

{"mcp.servers": {"memory": {"command": "npx","args": ["-y","@modelcontextprotocol/server-memory"],"env": {}},"blender": {"command": "uvx","args": ["blender-mcp"],"env": {}}}
}

5. 启动 Blender MCP 服务器

在 Blender 中启动：

1. 启动 Blender

2. 按 N 键打开侧边栏

3. 定位到 Blender MCP 选项卡

4. 点击 Start MCP Server 按钮

或者通过命令行启动：

uvx blender-mcp

6. 验证配置

• 重启 Visual Studio Code

• 确保 Blender 已打开且 MCP 服务器正在运行

• 在 Visual Studio Code 中尝试发送指令，例如：

      -   "创建一个立方体"-   "添加一个带有纹理的球体"-   "创建一个简单的场景"

如果 Blender 响应并执行相应操作，说明配置成功！

常见问题

Q: 找不到 uvx 命令？

A: 确保 uv 已正确安装并添加到系统 PATH 中。可以尝试：

# 检查 uv 是否安装
uv --version
​
# 如果未找到，可能需要重启终端或重新安装

Q: Blender 插件无法启用？

A:

• 确保 Blender 版本兼容（建议使用 Blender 3.0+）

• 检查插件是否完整下载

• 查看 Blender 控制台是否有错误信息

Q: Visual Studio Code 无法连接到 MCP 服务器？

A:

• 确保 Blender MCP 服务器正在运行（在 Blender 中或通过命令行）

• 检查 Visual Studio Code 的 MCP 配置是否正确

• 重启 Visual Studio Code 和 Blender

• 查看 Visual Studio Code 的开发者工具（Help > Toggle Developer Tools）中的错误信息

Q: Windows 上 uvx 命令不可用？

A: 在 Windows 上，可能需要使用完整路径或配置环境变量：

{"mcp.servers": {"blender": {"command": "python","args": ["-m", "uv", "tool", "run", "blender-mcp"],"env": {}}}
}

或者直接使用 uv 的完整路径：

{"mcp.servers": {"blender": {"command": "C:\\Users\\YourUsername\\.local\\bin\\uv","args": ["tool", "run", "blender-mcp"],"env": {}}}
}

使用示例

配置完成后，您可以在 Visual Studio Code 中使用自然语言指令来控制 Blender：

• "创建一个红色立方体，位置在 (0, 0, 0)"

• "添加一个带有金属材质的球体"

• "创建一个包含立方体、球体和圆柱体的场景"

• "将当前选中的对象旋转 45 度"

参考资源

• Blender MCP GitHub 仓库

• uv 包管理器文档

• Model Context Protocol 官方文档

完整配置示例

以下是一个包含多个 MCP 服务器的完整配置示例：

{"mcp.servers": {"memory": {"command": "npx","args": ["-y","@modelcontextprotocol/server-memory"],"env": {}},"blender": {"command": "uvx","args": ["blender-mcp"],"env": {}}},"ai.memory.enabled": true,"ai.memory.autoSave": true
}

---

提示：配置完成后，记得重启 Visual Studio Code 以使配置生效！