Openbim MCP

🚀 Fragment MCP Server

Fragment MCP Server是一個用於處理建築信息模型（BIM）文件的模型上下文協議（MCP）服務器。該服務器提供了將IFC文件轉換為片段格式、加載片段以及按類別查詢BIM數據的工具。

🚀 快速開始

你可以按照以下步驟快速啟動Fragment MCP Server：

1. 安裝依賴：

pnpm install

2. 運行服務器：

node main.ts

✨ 主要特性

• IFC到片段的轉換：將工業基礎類（IFC）文件轉換為開放且高效的片段格式。
• 片段加載：加載並處理預先轉換好的片段文件。
• 基於類別的查詢：按類別（如牆、門、窗）獲取BIM元素，並可配置屬性和關係。

📦 安裝指南

安裝依賴

pnpm install

運行服務器

node main.ts

💻 使用示例

基礎用法

1. 將IFC文件轉換為片段文件

使用convert-ifc-to-frag工具將IFC文件轉換為.frag文件格式，以便進行高效處理。

Input: /path/to/building.ifc
Output: /path/to/building.frag

2. 加載片段文件

使用load-frag工具將.frag文件加載到內存中，以便進行查詢。

3. 查詢指定類別的元素

使用fetch-elements-of-category工具從已加載的片段中獲取指定IFC類別的元素。

高級用法

在使用fetch-elements-of-category工具時，可以通過config參數進行更詳細的配置，例如：

{
  "category": "IFCWALL",
  "config": {
    "attributesDefault": true,
    "attributes": ["Name", "Length"],
    "relations": {
      "HasAssociations": true,
      "IsDefinedBy": true
    }
  }
}

📚 詳細文檔

工具說明

convert-ifc-to-frag

將IFC文件轉換為.frag文件格式，用於高效處理。 參數：

• inputPath（字符串）：要轉換的IFC文件的完整路徑。
• outputPath（字符串）：輸出的.frag文件的保存路徑。

load-frag

將.frag文件加載到內存中，以便進行查詢。 參數：

• filePath（字符串）：要加載的.frag文件的完整路徑。

fetch-elements-of-category

從已加載的片段中獲取指定IFC類別的元素。 參數：

• category（字符串）：類別名稱（如 "IFCWALL"、"IFCDOOR"、"IFCWINDOW"）。
• config（對象）：用於獲取元素的配置，結構如下：
  • attributesDefault（布爾值）：是否包含默認屬性。
  • attributes（數組）：要包含的特定屬性列表。
  • relations（對象）：關係配置。
    • HasAssociations：是否包含關聯關係。
    • IsDefinedBy：是否包含定義關係。

依賴項

• @modelcontextprotocol/sdk：MCP服務器框架。
• @thatopen/fragments：片段處理庫。
• web-ifc：IFC文件處理庫。
• zod：模式驗證庫。

Claude Desktop集成

要在Claude Desktop中使用此MCP服務器，請在Claude Desktop設置文件中添加以下配置：

配置步驟

1. 打開Claude Desktop設置。
2. 導航到MCP服務器配置。
3. 添加以下JSON配置：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/path/to/your/models/directory"
      ]
    },
    "bim": {
      "command": "npx",
      "args": [
        "-y",
        "tsx",
        "/path/to/your/openbim-mcp/main.ts"
      ]
    }
  }
}

Claude Desktop的先決條件

• 必須安裝Node.js，並且可以通過npx訪問。
• 應安裝tsx包（如有需要，可使用npm install -g tsx全局安裝）。
• 為了實現完整功能，需要同時配置文件系統服務器和BIM服務器。

使用工作流程

1. 將IFC轉換為片段：使用convert-ifc-to-frag將IFC文件轉換為高效的片段格式。
2. 加載片段：使用load-frag將片段文件加載到內存中。
3. 查詢元素：使用fetch-elements-of-category按IFC類別檢索特定的建築元素。

支持的IFC類別

可以查詢的常見類別包括：

• IFCWALL - 牆
• IFCDOOR - 門
• IFCWINDOW - 窗
• IFCSLAB - 樓板
• IFCBEAM - 梁
• IFCCOLUMN - 柱
• IFCSPACE - 空間/房間

要求

• Node.js
• 具有讀取IFC文件和寫入片段文件的文件系統訪問權限
• 與模型上下文協議客戶端兼容

📄 許可證

文檔未提及相關信息，故跳過該章節。

🔧 技術細節

文檔未提及相關信息，故跳過該章節。

作者

Helen Kwok