get_ifc_project_infoLABSCO SUMMARY
Goes past inspection into the deliverables an architect actually owes someone.
Reading an IFC model is where most of these stop. Exporting a floor plan as a PNG, and generating a BC3 budget with elements categorised, measured by the right metric and priced from a customisable table, is a different class of output - it produces the document, not just the answer. The unit prices and category mappings are JSON files you can edit for your region.
What it is
A fork of BlenderMCP focused on IFC. A Blender addon opens a socket inside Blender; the MCP server talks to it, reaching the IFC model through the Bonsai BIM addon and ifcopenshell.
What you get
- Project overview - name, description and entity counts - and entity listings filtered by type or by what is selected in Blender
- All properties of an entity by its GlobalId, its relationships, and the spatial hierarchy from site down to spaces
- Quantities - areas, volumes - for elements, filtered by type or selection
- The complete structure combining spatial hierarchy with the building elements inside each container
- The current Blender viewport captured as an image, so the model can be looked at as well as queried
- Export of IFC data to JSON or CSV, high-resolution PNG plan and 3D drawings, and a BC3 construction budget in the Spanish FIEBDC standard
- Georeferencing read back, and coordinate reference systems written into the model
- Sequential thinking for stepwise analysis, and the original arbitrary-Python-in-Blender tool
Requirements
Blender 4.0 or newer with the Bonsai BIM addon and an IFC file loaded, Python 3.12 or newer, and uv. Install the repository's addon.py into Blender, enable it, and start the connection from the 3D View sidebar before the tools will work. A Dockerfile is provided that exposes the same tools as a REST and OpenAPI service on port 8000 for clients that are not MCP. The arbitrary code execution tool inherited from the original project is still present - it runs any Python inside Blender, so save your work.
Setup effort
Build from source — git clone https://github.com/JotaDeRodriguez/Bonsai_mcp
USE CASES
01
Getting the measure of an unfamiliar model
Read the project information and the spatial structure, then list the entity types you care about.
02
Answering a question about one element
Pull its properties by GlobalId and read its relationships, or work from whatever is selected in Blender.
03
Producing a quantity take-off
Calculate the quantities per element type, then export the data as CSV for the spreadsheet it has to land in.
04
Building a construction budget
Generate the BC3 file from the loaded model, with elements grouped by category, measured and priced from the unit-price table.
05
Producing drawings for a report
Export orthographic plan views at the resolution you need, and capture the current viewport for the 3D illustration.
06
Placing the model in the real world
Read what georeferencing already exists, then set the coordinate reference system and map conversion.
16 tools
Listed in project docs. Your client may show a different list.
list_ifc_entitiesget_ifc_propertiesget_ifc_spatial_structureget_ifc_relationshipsget_selected_ifc_entitiesget_user_viewexport_ifc_dataplace_ifc_objectget_ifc_quantitiesget_ifc_total_structureexport_drawing_pngget_ifc_georeferencing_infogeoreference_ifc_modelexport_bc3_budgetexecute_blender_codeBEFORE YOU INSTALL
What to know first
Tools you get
16 tools named in the project's documentation.
Requires
- Blender 4.0 or newer, with the Bonsai BIM addon
- uv on PATH
- Python 3.12 or later
INSTALLATION
Connect your client
This one is built from source rather than installed with a single command.
Server setup
TERMINAL
git clone https://github.com/JotaDeRodriguez/Bonsai_mcpIn Blender, go to Edit > Preferences > Add-ons, click "Install..." and select the addon.py file from the clone
Enable the addon by checking the box next to "Interface: Blender MCP - IFC"
With an IFC model loaded through the Bonsai BIM addon, open the 3D View sidebar (press N), find the "Blender MCP - IFC" tab and click "Connect to Claude"
MCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"Bonsai-mcp": {
"command": "uv",
"args": [
"--directory",
"<YOUR_PATH_TO_BONSAI_MCP>",
"run",
"tools.py"
]
}
}
}\your\path\to\Bonsai_mcp is the full path of the Bonsai_mcp folder the clone created.
Open WebUI — REST bridge
OPEN WEBUI — REST BRIDGE · TERMINAL
cd Bonsai_mcp
docker build -t bonsai_mcp .
docker run -p 8000:8000 --name bonsai_mcp bonsai_mcpIn Open WebUI, go to Settings > Manage Tool Servers and add a connection with URL http://localhost:8000, Path to OpenAPI spec /openapi.json and Authentication None (unless configured otherwise)
This route serves the tools as a REST/OpenAPI API rather than over MCP, and Blender must still be running with the addon connected.
