Bonsai-mcp は、BONSAI を介した IFC (Industry Foundation Classes) モデルを専用のサポートでオリジナル機能を拡張するBlenderMCPのフォークです。 この統合は、LMS が IFC ファイルを読み、変更できるようにするプラットフォームです。

##特徴

• IFC固有の機能: IFCモデルをクエリし、空間構造を分析し、建物の要素を調べ、量を抽出する

• Eleven IFCツールが含まれています: プロジェクト情報、リストのエンティティティティを調べ、プロパティを調べ、空間構造を探索し、関係を分析するなど

-シーケンシャル思考:構造問題解決のためのmodelcontextprotocol/serversからのシーケンシャル思考ツールが含まれています

• 元のBlenderMCPの実装からのコードツールをエクスポート: オブジェクトの作成と変更、材料の応用、およびBlenderのPythonコードの実行

コンポーネント

システムは2つの主要なコンポーネントで構成されます。

1. ベンダーアドオン(addon.py): Blender内でソケットサーバーを作成するBlenderアドオンで、IFC固有の操作を含むコマンドを受信および実行できます。

2.MCPサーバー(tools.py): Model Context プロトコルを実装し、Blender addon に接続する Python サーバー

##インストール - MCPクライアント設定による

Bonsai-mcp - Model Context Protocol Integration for IFC through IfcOpenShell and Blender

Bonsai-mcp is a fork of BlenderMCP that extends the original functionality with dedicated support for IFC (Industry Foundation Classes) models through Bonsai. This integration is a platform to let LLMs read and modify IFC files.

Features

• IFC-specific functionality: Query IFC models, analyze spatial structures, examine building elements and extract quantities

• Eleven IFC tools included: Inspect project info, list entities, examine properties, explore spatial structure, analyze relationships and more

• Sequential Thinking: Includes the sequential thinking tool from modelcontextprotocol/servers for structured problem solving

• Execute Code tool from the original BlenderMCP implementation: Create and modify objects, apply materials, and execute Python code in Blender

Components

The system consists of two main components:

1. Blender Addon (addon.py): A Blender addon that creates a socket server within Blender to receive and execute commands, including IFC-specific operations

2. MCP Server (tools.py): A Python server that implements the Model Context Protocol and connects to the Blender addon

Installation - Through MCP Client Settings

Prerequisites

• Blender 4.0 or newer

• Python 3.12 or newer

• uv package manager

• Bonsai BIM addon for Blender (for IFC functionality)

Installing uv:

Mac:

brew  install  uv

Windows:

powershell  -c  "irm https://astral.sh/uv/install.ps1 | iex"

set  Path=C:\Users\[username]\.local\bin;%Path%

For other platforms, see the uv installation guide.

Clone the repository

git  clone  https://github.com/JotaDeRodriguez/Bonsai_mcp

Claude for Desktop Integration

Edit your claude_desktop_config.json file (Claude > Settings > Developer > Edit Config) to include:

{
    "mcpServers": {
        "Bonsai-mcp": {
            "command": "uv",
            "args": [
              "--directory",
              "\\your\\path\\to\\Bonsai_mcp",
              "run",
              "tools.py"
          ]
        }
    }
}

Installation via Docker

The repository comes with a Dockerfile that makes deployment simple and consistent across different environments.

Quick Start

# Clone the repository
git clone https://github.com/JotaDeRodriguez/Bonsai_mcp
cd Bonsai_mcp

# Build the Docker image
docker build -t bonsai_mcp .

# Run the container
docker run -p 8000:8000 --name bonsai_mcp bonsai_mcp

Once running, the container will expose the MCP tools as REST/OpenAPI APIs at http://localhost:8000.

• To verify youtr installation, open your browser and navigate to
• http://localhost:8000/docs