Blender MCP + Cursor AI MCP = cuBe

基本能力

产品定位

cuBe是一个Blender插件，旨在通过MCP协议实现Blender与AI助手的集成，提供程序化控制Blender的能力。

核心功能

• 双向通信：通过基于套接字的服务器连接Claude AI或Cursor到Blender
• 对象操作：在Blender中创建、修改和删除3D对象
• 材质控制：应用和修改材质和颜色
• 场景检查：获取当前Blender场景的详细信息
• 代码执行：在Blender中运行任意Python代码
• 视口捕获：捕获当前Blender视口并作为图像接收
• 场景指标：从Blender获取详细的性能和场景统计信息
• 实时预览：实时流式传输连续视口更新

适用场景

• AI助手与Blender的集成
• 自动化3D建模和场景操作
• 实时3D场景监控和反馈
• 教育和培训中的3D建模演示

工具列表

• BlenderMCP：主插件，提供MCP服务器功能
• test_blendermcp.py：基本连接测试脚本
• test_viewport.py：测试高级视口和指标功能的脚本

常见问题解答

• 端口已被占用：可以在Blender的BlenderMCP面板中更改端口
• 插件未找到：确保插件已正确安装并在Blender的偏好设置中启用
• 连接失败：检查服务器是否正在运行，以及是否有防火墙阻止连接
• 视口捕获问题：确保在Blender设置中有3D视口区域
• 实时预览不工作：检查是否有其他服务正在使用指定的预览端口

使用教程

使用依赖

• Python 3.6或更高版本
• Blender 2.80或更高版本

安装教程

Windows

1. 下载或克隆此仓库
2. 双击install.bat
3. 按照安装程序中的提示操作

macOS/Linux

1. 下载或克隆此仓库
2. 打开终端并导航到仓库文件夹
3. 使安装脚本可执行：chmod +x install.sh
4. 运行安装程序：./install.sh
5. 按照安装程序中的提示操作

手动安装

1. 将addon.py复制到Blender的插件目录
2. Windows: C:\Program Files\Blender Foundation\Blender\[version]\scripts\addons\
3. macOS: /Applications/Blender.app/Contents/Resources/scripts/addons/或~/Library/Application Support/Blender/[version]/scripts/addons/
4. Linux: /usr/share/blender/scripts/addons/或~/.config/blender/scripts/addons/
5. 将文件重命名为blendermcp.py
6. 启动Blender并启用插件：
7. 转到编辑 > 偏好设置 > 插件
8. 搜索"BlenderMCP"
9. 勾选复选框以启用

调试方式

1. 安装完成后，启动Blender
2. 在3D视口中，按N打开侧边栏
3. 找到"BlenderMCP"标签
4. 点击"Start MCP Server"以在默认端口(9876)上启动服务器
5. 从Cursor AI或其他MCP客户端连接到服务器

测试连接

安装程序会自动测试连接，在默认立方体上方创建一个球体。如果看到球体出现在立方体上方，则安装成功。

也可以运行包含的测试脚本： - test_blendermcp.py - 基本连接测试 - test_viewport.py - 测试高级视口和指标功能

与Cursor AI集成

1. 打开Cursor设置
2. 导航到MCP设置
3. 添加BlenderMCP命令：uvx blender-mcp

许可证

该项目遵循 GPLv3 开源许可条款。