Skip to main content
Glama

Fragment MCP Server

by helenkwok

Fragment MCP Server

A Model Context Protocol (MCP) server for working with Building Information Modeling (BIM) files. This server provides tools to convert IFC files to fragment format, load fragments, and query BIM data by category.

Features

  • IFC to Fragment Conversion: Convert Industry Foundation Classes (IFC) files to the open and efficient fragment format
  • Fragment Loading: Load and work with pre-converted fragment files
  • Category-based Querying: Fetch BIM elements by category (e.g., walls, doors, windows) with configurable attributes and relations

Tools

convert-ifc-to-frag

Converts an IFC file to a .frag file format for efficient processing.

Parameters:

  • inputPath (string): Full path of the IFC file to convert
  • outputPath (string): Full path where the output .frags file will be saved

Example:

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

load-frag

Loads a .frag file into memory for querying.

Parameters:

  • filePath (string): Full path of the .frag file to load

fetch-elements-of-category

Fetches elements of a specified IFC category from loaded fragments.

Parameters:

  • category (string): Category name (e.g., "IFCWALL", "IFCDOOR", "IFCWINDOW")
  • config (object): Configuration for fetching elements with the following structure:
    • attributesDefault (boolean): Include default attributes
    • attributes (array): List of specific attributes to include
    • relations (object): Relation configuration
      • HasAssociations: Include association relations
      • IsDefinedBy: Include definition relations

Dependencies

Installation

  1. Install dependencies:
pnpm install
  1. Run the server:
node main.ts

Claude Desktop Integration

To use this MCP server with Claude Desktop, add the following configuration to your Claude Desktop settings file:

Configuration

  1. Open Claude Desktop settings
  2. Navigate to the MCP servers configuration
  3. Add the following JSON configuration:
{ "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" ] } } }

Prerequisites for Claude Desktop

  • Node.js must be installed and accessible via npx
  • The tsx package should be available (install globally with npm install -g tsx if needed)
  • Both the filesystem and bim servers need to be configured for full functionality

Usage Workflow

  1. Convert IFC to Fragment: Use convert-ifc-to-frag to convert your IFC file to the efficient fragment format
  2. Load Fragments: Use load-frag to load the fragment file into memory
  3. Query Elements: Use fetch-elements-of-category to retrieve specific building elements by their IFC category

Supported IFC Categories

Common categories you can query include:

  • IFCWALL - Walls
  • IFCDOOR - Doors
  • IFCWINDOW - Windows
  • IFCSLAB - Slabs/Floors
  • IFCBEAM - Beams
  • IFCCOLUMN - Columns
  • IFCSPACE - Spaces/Rooms

Requirements

  • Node.js
  • File system access for reading IFC files and writing fragment files
  • Compatible with Model Context Protocol clients

Author

Helen Kwok

-
security - not tested
A
license - permissive license
-
quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

A Model Context Protocol server that enables working with Building Information Modeling (BIM) files by converting IFC files to fragment format and querying BIM data by category.

  1. Features
    1. Tools
      1. convert-ifc-to-frag
      2. load-frag
      3. fetch-elements-of-category
    2. Dependencies
      1. Installation
        1. Claude Desktop Integration
          1. Configuration
          2. Prerequisites for Claude Desktop
        2. Usage Workflow
          1. Supported IFC Categories
            1. Requirements
              1. Author

                Related MCP Servers

                • -
                  security
                  A
                  license
                  -
                  quality
                  A Model Context Protocol server that provides file system operations, analysis, and manipulation capabilities through a standardized tool interface.
                  Last updated -
                  4
                  TypeScript
                  MIT License
                • A
                  security
                  F
                  license
                  A
                  quality
                  A Model Context Protocol server that integrates with Figma's API, allowing interaction with Figma files, comments, components, projects, and webhook management.
                  Last updated -
                  5
                  909
                  JavaScript
                • -
                  security
                  F
                  license
                  -
                  quality
                  A Model Context Protocol server that connects AI tools and LLMs to Figma designs, enabling them to extract design data, analyze design systems, and generate development documentation.
                  Last updated -
                  69
                  1
                  TypeScript
                  • Apple
                • -
                  security
                  A
                  license
                  -
                  quality
                  A server that implements the Model Context Protocol, providing a standardized way to connect AI models to different data sources and tools.
                  Last updated -
                  2
                  7
                  TypeScript
                  MIT License

                View all related MCP servers

                MCP directory API

                We provide all the information about MCP servers via our MCP API.

                curl -X GET 'https://glama.ai/api/mcp/v1/servers/helenkwok/openbim-mcp'

                If you have feedback or need assistance with the MCP directory API, please join our Discord server