Cube (Blender)

🚀 Blender MCP + Cursor AI MCP = cuBe

本项目提供了用于安装和配置BlenderMCP插件的工具，该插件可通过模型上下文协议（MCP）将Blender与Cursor AI集成，实现AI对Blender的程序化控制，为3D创作带来新的可能。

🚀 快速开始

cuBe是Blender的一款强大插件，借助socket连接，能对Blender进行程序化控制，让Cursor AI等AI助手得以创建和操作Blender中的3D对象。其使用步骤如下：

1. 启动Blender并启用BlenderMCP插件。
2. 在Blender的设置中找到BlenderMCP面板。
3. 配置所需的端口和其他参数。
4. 启动服务器。
5. 从客户端连接到BlenderMCP服务器。

✨ 主要特性

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

📦 安装指南

前置条件

• 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. 按照安装程序中的提示进行操作。

💻 使用示例

基础用法

cuBe的基础使用就是按照上述快速开始的步骤，连接AI与Blender，实现基本的3D对象操作。

高级用法

• 视口捕获：通过调用bmcapture.start()开始捕获，使用bmcapture.stop()停止捕获，并将结果保存到指定路径。
• 实时预览：启动实时预览服务，其他客户端可以通过连接到指定端口查看实时更新。

📚 详细文档

官方仓库

• BlenderMCP的官方仓库托管在GitHub上：https://github.com/ahujasid/blender-mcp，请访问该仓库以获取最新更新、功能和社区贡献。
• cuBe的官方仓库托管在Github：https://github.com/TheMapleseed/cuBe。

故障排除

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

📄 许可证

本软件根据 GPLv3 许可证提供。

🔗 贡献指南

欢迎大家为项目贡献力量！