Bonsai MCP

🚀 bonsai-mcp - Blender Model Context Protocol 对 IFC 的集成通过 IfcOpenShell

Bonsai-mcp 是 BlenderMCP 的分支项目，它扩展了原项目功能，借助 Bonsai 为 IFC（Industry Foundation Classes）模型提供专门支持。此集成是一个快速概念验证，旨在展示将 Claude（或其他大语言模型，不过这里仅测试了 Claude 桌面客户端）连接到 Blender 以执行 IfcOpenShell 命令的能力。

✨ 主要特性

• 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，请按以下步骤进行安装和配置：

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 模型"

💻 使用示例

基础用法

以下是一些示例命令，展示如何通过 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 服务器已正确配置。
• 验证 Bonsai BIM 插件是否安装并加载了 IFC 文件。
• 若出现超时错误，尝试简化请求或将操作分解为更小步骤。