Bonsai MCP

🚀 bonsai - mcp - Blender 模型上下文協議對 IFC 的集成通過 IfcOpenShell

Bonsai - mcp 是 BlenderMCP 的一個分支，它擴展了原項目功能，藉助 Bonsai 提供專門的 IFC（Industry Foundation Classes）模型支持。此集成作為快速概念驗證，旨在展示將 Claude（或其他大語言模型，不過這裡僅測試了 Claude 桌面客戶端）連接到 Blender 以執行 IfcOpenShell 命令的能力。

🚀 快速開始

若要使用 Bonsai - mcp，可按以下步驟進行安裝和配置：

1. 安裝依賴項

確保已安裝以下軟件：

• Blender（建議版本 3. x）
• Python（建議版本 3.8 或更高）
• IfcOpenShell
• Bonsai BIM 插件

2. 克隆倉庫

git clone https://github.com/yourusername/bonsai-mcp.git
cd bonsai-mcp

3. 安裝 Python 包

安裝所需的 Python 包：

pip install -r requirements.txt

4. 啟動服務器

啟動 Bonsai - mcp 服務器：

python server.py

5. 使用客戶端

使用提供的客戶端腳本與服務器交互。例如，要發送一條消息：

python client.py --message "分析這個 IFC 模型"

✨ 主要特性

• IFC 特定功能：可查詢 IFC 模型、分析空間結構並檢查建築元素。
• 五個強大的 IFC 工具：能查看項目信息、列出實體、檢查屬性、探索空間結構和分析關係。
• 順序思維工具：源自 modelcontextprotocol/servers 的順序思維工具，用於結構化問題解決。
• 執行代碼工具（來自原始 BlenderMCP 實現）：可創建和修改對象、應用材質並在 Blender 中執行 Python 代碼。
• 經過驗證的標準模型：與默認的 ifcopenshell 房屋模型兼容。

🔧 技術細節

IFC 集成藉助 Bonsai BIM 模塊訪問 IfcOpenShell 功能。通信遵循與原始 BlenderMCP 相同的基於 JSON 的協議，通過 TCP 套接字進行。

📚 詳細文檔

項目結構

bonsai - mcp 項目分為兩個主要部分：

1. server：負責處理來自客戶端（如 Claude）的請求，並執行相應的操作。
2. client：用於與服務器通信，併發送指令以控制 Blender 中的操作。

示例命令

以下是一些示例命令，展示如何通過 Bonsai - mcp 進行操作：

基礎用法

• 查詢模型信息：

python client.py --message "get_model_info"

• 列出所有實體：

python client.py --message "list_entities"

高級用法

• 執行順序思維工具：

python client.py --message "sequential_thinking analyze_building_energy_efficiency"

📄 許可證

歡迎貢獻！請參考項目倉庫中的許可文件以瞭解使用條款。

⚠️ 重要提示

• 連接問題：確保 Blender 插件服務器正在運行，並且 Claude 中的 MCP 服務器已正確配置。
• IFC 模型未加載：驗證 Bonsai BIM 插件是否安裝並加載了 IFC 文件。
• 超時錯誤：嘗試簡化請求或將操作分解為更小步驟。