关键词

IFCBlenderBIMLLM建筑设计

项目简介

Bonsai MCP 是一个基于 Model Context Protocol (MCP) 的服务器实现，旨在桥接 Blender 和大型语言模型 (LLM)，特别是 Claude。它扩展了原有的 BlenderMCP 功能，专注于 IFC（工业基础类）模型集成，利用 Bonsai BIM 插件增强了对建筑信息模型 (BIM) 的支持。通过 Bonsai MCP，用户可以使用自然语言指令，让 LLM 客户端（如 Claude）直接查询 IFC 模型数据、分析建筑结构、并控制 Blender 执行各种操作，从而实现智能化的 BIM 工作流程。

主要功能点

  • IFC 模型交互: 提供强大的 IFC 数据访问能力，允许 LLM 查询 IFC 项目信息、实体列表、属性、空间结构和实体关系。
  • Blender 功能扩展: 支持通过 LLM 指令执行 Blender Python 代码，实现场景创建、对象修改等 Blender 内的功能控制。
  • 顺序思考工具: 集成了顺序思考工具，支持 LLM 进行结构化的、逐步深入的问题分析和解决。
  • 易于集成: 设计为 MCP 服务器，可以方便地与任何支持 MCP 协议的 LLM 客户端集成，示例中提供了与 Claude Desktop 的集成配置。

安装步骤

  1. 环境准备:

    • 安装 Blender 3.0 或更高版本。
    • 安装 Python 3.10 或更高版本。
    • 安装 uv 包管理器 (用于 Python 包管理，推荐使用仓库提供的安装方式)。
    • 安装 Bonsai BIM 插件 for Blender (用于 IFC 功能支持，请参考 Bonsai BIM 插件的安装文档)。

  2. 安装 uv 包管理器:

    • MacOS: 打开终端，运行命令 'brew install uv'。
    • Windows: 打开 PowerShell，运行命令 'powershell -c "irm https://astral.sh/uv/install.ps1 | iex"'，然后设置环境变量 'set Path=C:\Users[username].local\bin;%Path%' (请将 '[username]' 替换为您的用户名)。
    • 其他平台请参考 uv 安装指南。

  3. 克隆仓库:

    • 打开终端或命令提示符，运行命令 'git clone https://github.com/JotaDeRodriguez/Bonsai_mcp'。

  4. 安装 Blender 插件:

    • 下载仓库中的 'addon.py' 文件。
    • 打开 Blender。
    • 点击 "编辑" -> "偏好设置" -> "插件"。
    • 点击 "安装..."，选择下载的 'addon.py' 文件。
    • 在插件列表中找到 "Interface: Blender MCP - IFC"，勾选启用插件。

服务器配置

本仓库主要用于 Claude Desktop 客户端，以下是 Claude Desktop 的 MCP 服务器配置信息，请添加到 Claude 的 'claude_desktop_config.json' 配置文件中 (Claude 客户端 -> 设置 -> 开发者 -> 编辑配置)。

{
    "mcpServers": {
        "Bonsai-mcp": {
            "command": "uv",
            "args": [
              "--directory",
              "你的Bonsai_mcp仓库路径",
              "run",
              "tools.py"
          ]
        }
    }
}

配置参数说明:

  • '"Bonsai-mcp"': 服务器名称，可以自定义，在 Claude 界面中用于识别和选择该服务器。
  • '"command": "uv"': 启动服务器的命令，这里使用 uv 包管理器来运行 Python 脚本。
  • '"args"': 启动命令的参数列表。
    • '"--directory"': 指定工作目录为 Bonsai_mcp 仓库的根目录。 请将 '"你的Bonsai_mcp仓库路径"' 替换为 Bonsai_mcp 仓库在您本地文件系统中的实际路径。
    • '"run"': uv 命令的子命令，用于运行 Python 脚本。
    • '"tools.py"': 要运行的 MCP 服务器 Python 脚本文件名。

基本使用方法

  1. 启动 Blender 插件服务器:

    • 打开 Blender，加载包含 IFC 模型的 Blender 文件 (需先安装并启用 Bonsai BIM 插件才能正确加载 IFC 文件)。
    • 在 Blender 界面右侧边栏 (按 N 键显示/隐藏边栏)，找到 "Blender MCP - IFC" 选项卡。
    • 点击 "Connect to Claude" 按钮，启动 Blender 插件内置的 socket 服务器。

  2. 启动 MCP 服务器:

    • 打开终端或命令提示符，导航到 Bonsai_mcp 仓库根目录。
    • 运行命令 (根据 Claude Desktop 配置中的 'command' 和 'args'): 'uv run tools.py'。
    • 确保 MCP 服务器成功启动，并监听默认端口 (9876)。

  3. 在 Claude 中使用:

    • 确保 Claude Desktop 客户端已正确配置 Bonsai-mcp 服务器 (参考 "服务器配置" 步骤)。
    • 在 Claude 界面中，您应该能看到一个锤子图标，表示 Bonsai MCP 服务器已连接并提供工具。
    • 您可以使用自然语言指令，结合提供的 IFC 工具和 Blender 代码执行工具，与 Blender 和 IFC 模型进行交互。例如:
      • "Analyze this IFC model and tell me how many walls, doors and windows it has"
      • "Show me the spatial structure of this building model"
      • "List all spaces in this IFC model and their properties"

注意: 首次使用或遇到连接问题时，请仔细检查 Blender 插件服务器和 MCP 服务器是否都已成功启动，并检查 Claude Desktop 的配置是否正确。

信息

分类

桌面与硬件

访问项目