Openbim MCP

🚀 Fragment MCP Server

このサーバーは、Building Information Modeling (BIM) ファイルを扱うためのModel Context Protocol (MCP) サーバーです。IFCファイルをフラグメント形式に変換し、フラグメントをロードし、BIMデータをカテゴリでクエリするツールを提供します。

✨ 主な機能

• IFCからフラグメントへの変換：Industry Foundation Classes (IFC) ファイルをオープンで効率的なフラグメント形式に変換します。
• フラグメントのロード：事前に変換されたフラグメントファイルをロードして操作します。
• カテゴリベースのクエリ：設定可能な属性と関係を持つ、特定のカテゴリ（例：壁、ドア、窓）のBIM要素を取得します。

📦 インストール

1. 依存関係をインストールします。

pnpm install

2. サーバーを起動します。

node main.ts

💻 使用例

基本的な使用法

1. IFCをフラグメントに変換する：convert-ifc-to-frag を使用して、IFCファイルを効率的なフラグメント形式に変換します。

# ここでは具体的なコマンド例を示します
npx convert-ifc-to-frag --inputPath /path/to/building.ifc --outputPath /path/to/building.frag

2. フラグメントをロードする：load-frag を使用して、フラグメントファイルをメモリにロードします。

npx load-frag --filePath /path/to/building.frag

3. 要素をクエリする：fetch-elements-of-category を使用して、特定のIFCカテゴリの建物要素を取得します。

npx fetch-elements-of-category --category IFCWALL --config '{"attributesDefault": true, "attributes": [], "relations": {"HasAssociations": true, "IsDefinedBy": true}}'

高度な使用法

特定の属性や関係を指定して要素を取得する高度なクエリを行うことができます。

# 例えば、特定の属性と関係を指定して壁要素を取得する
npx fetch-elements-of-category --category IFCWALL --config '{"attributesDefault": false, "attributes": ["Width", "Height"], "relations": {"HasAssociations": true, "IsDefinedBy": false}}'

📚 ドキュメント

ツールの詳細

convert-ifc-to-frag

IFCファイルを効率的な処理のために .frag ファイル形式に変換します。

パラメーター：

例：

入力: /path/to/building.ifc
出力: /path/to/building.frag

load-frag

メモリに .frag ファイルをロードしてクエリを実行できるようにします。

パラメーター：

fetch-elements-of-category

ロードされたフラグメントから指定されたIFCカテゴリの要素を取得します。

パラメーター：

Claude Desktopとの統合

このMCPサーバーをClaude Desktopと一緒に使用するには、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サーバーの両方を構成する必要があります。

サポートされるIFCカテゴリ

クエリ可能な一般的なカテゴリは以下の通りです。

• IFCWALL - 壁
• IFCDOOR - ドア
• IFCWINDOW - 窓
• IFCSLAB - スラブ/床
• IFCBEAM - 梁
• IFCCOLUMN - 柱
• IFCSPACE - 空間/部屋

要件

• Node.js
• IFCファイルの読み取りとフラグメントファイルの書き込みのためのファイルシステムアクセス
• Model Context Protocolクライアントと互換性がある必要があります。

依存関係

作者

Helen Kwok