Cube (Blender)

🚀 Blender MCP + Cursor AI MCP = cuBe

cuBe是一個用於Blender的插件包，它提供了一系列工具，可實現Blender與Cursor AI的集成。通過模型上下文協議（MCP）和socket連接，能讓AI助手對Blender進行程序化控制，輕鬆創建和操作3D對象。

🚀 快速開始

cuBe是Blender的一個插件，允許通過socket連接實現對Blender的程序化控制。這使得像Cursor AI這樣的AI助手能夠創建和操作Blender中的3D對象。

✨ 主要特性

• 雙向通信：通過socket-based服務器將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. 按照安裝程序中的提示進行操作

💻 使用示例

基礎用法

1. 啟動Blender並啟用BlenderMCP插件
2. 在Blender的設置中找到BlenderMCP面板
3. 配置所需的端口和其他參數
4. 啟動服務器
5. 從客戶端連接到BlenderMCP服務器

高級用法

• 視口捕獲：通過調用bmcapture.start()開始捕獲，使用bmcapture.stop()停止捕獲，並將結果保存到指定路徑。
• 即時預覽：啟動即時預覽服務，其他客戶端可以通過連接到指定端口查看即時更新。

📚 詳細文檔

官方倉庫

BlenderMCP的官方倉庫託管在GitHub上： https://github.com/ahujasid/blender-mcp

請訪問該倉庫以獲取最新更新、功能和社區貢獻。

cuBe的官方倉庫

cuBe的官方倉庫託管在
Github: https://github.com/TheMapleseed/cuBe

🔧 技術細節

故障排除

• 端口被佔用：如果端口9876已被佔用，請在BlenderMCP面板中更改端口
• 插件未找到：請確保插件已正確安裝並在Blender首選項中啟用
• 連接失敗：檢查服務器是否運行，確保沒有防火牆阻止連接
• 視口捕獲問題：請確保Blender中有有效的3D視口區域
• 即時預覽不工作：請檢查是否有其他服務正在使用指定的預覽端口

貢獻指南

歡迎貢獻！

📄 許可證

本軟件根據 GPLv3 許可證提供。