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 文件。
• 超时错误：尝试简化请求或将操作分解为更小步骤。