ifc-mcp

MCP server for exploring and querying IFC (Industry Foundation Classes) building models.

Install

pip install ifc-mcp

ifc-mcp must be on your PATH for MCP clients that use command: "ifc-mcp".

which ifc-mcp
ifc-mcp --help
ifc-mcp --version

Run

Start once and load models dynamically during chat:

ifc-mcp serve

Optional preload:

ifc-mcp serve /absolute/path/to/model.ifc

HTTP transport:

ifc-mcp serve --transport http --port 8000

MCP client config

{
  "mcpServers": {
    "ifc_mcp": {
      "command": "ifc-mcp",
      "args": ["serve"]
    }
  }
}

Typical workflow in chat

1. load_model(file_path="/absolute/path/to/model.ifc") (fast default)
2. get_model_summary()
3. Query with tools by element, space, material, property, or type.

Most tools also accept optional file_path for one-shot queries.

Geometry is loaded lazily by default for speed. Use eager mode only when needed:

• MCP tool: load_model(file_path="...", with_geometry=true)
• CLI preload: ifc-mcp serve /absolute/path/to/model.ifc --with-geometry
• Session status: get_loaded_model() includes geometry_loaded

Relationship tools

ifc-mcp includes element relationship tools based on IfcRelContainedInSpatialStructure and IfcRelAggregates:

• classify_elements_by_relation(file_path="/absolute/path/to/model.ifc") returns parent, child, and investigate buckets for IfcElement records.
• get_aggregate_relationships(file_path="/absolute/path/to/model.ifc") returns aggregate parents, their children, and a flat child_to_parent map.
• find_orphans(file_path="/absolute/path/to/model.ifc", exclude_classes=["IfcOpeningElement"]) returns elements with neither spatial containment nor aggregate parent links.

License

MIT