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

Bonsai-mcp 是 BlenderMCP 的一个分支，扩展了其功能，并通过 Bonsai 提供专门的 IFC（Industry Foundation Classes）模型支持。此集成是一个快速的概念验证，旨在展示将 Claude（或其他 LLM，尽管这里仅测试了 Claude Desktop Client）连接到 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 服务器已正确配置。
• IFC 模型未加载：验证 Bonsai BIM 插件是否安装并加载了 IFC 文件。
• 超时错误：尝试简化请求或将操作分解为更小步骤。

贡献和许可

欢迎贡献！请参考项目仓库中的许可文件以了解使用条款。