🚀 Blender MCP + Cursor AI MCP = cuBe
本项目提供了用于安装和配置BlenderMCP插件的工具，该插件可通过模型上下文协议（MCP）将Blender与Cursor AI集成，实现AI对Blender的程序化控制，为3D创作带来新的可能。
🚀 快速开始
cuBe是Blender的一款强大插件，借助socket连接，能对Blender进行程序化控制，让Cursor AI等AI助手得以创建和操作Blender中的3D对象。其使用步骤如下：
- 启动Blender并启用BlenderMCP插件。
- 在Blender的设置中找到BlenderMCP面板。
- 配置所需的端口和其他参数。
- 启动服务器。
- 从客户端连接到BlenderMCP服务器。
✨ 主要特性
- 双向通信：通过基于socket的服务器，可将Claude AI或Cursor连接到Blender。
- 对象操作：支持在Blender中创建、修改和删除3D对象。
- 材质控制：能应用和修改材质及颜色。
- 场景检查：可获取当前Blender场景的详细信息。
- 代码执行：允许在Blender中运行任意Python代码。
- 视口捕获：能够捕获当前Blender视口，并将其作为图像接收。
- 场景指标：可获取Blender的详细性能和场景统计信息。
- 实时预览：支持流式传输实时视口更新。
📦 安装指南
前置条件
- Python 3.6或更高版本。
- Blender 2.80或更高版本。
安装步骤
Windows
- 下载或克隆此仓库。
- 双击
install.bat。 - 按照安装程序中的提示进行操作。
macOS/Linux
- 下载或克隆此仓库。
- 打开终端并导航到仓库文件夹。
- 使安装脚本可执行：
chmod +x install.sh。 - 运行安装程序：
./install.sh。 - 按照安装程序中的提示进行操作。
💻 使用示例
基础用法
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 许可证提供。
🔗 贡献指南
欢迎大家为项目贡献力量！