Fragment MCP Server
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.
What is Fragment MCP Server?
Fragment MCP Server is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 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.
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.
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A Model Context Protocol server that enables working with Bu
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx fragment-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Fragment MCP Server
The Fragment MCP Server (openbim-mcp) is a TypeScript-based MCP server for working with Building Information Modeling (BIM) files. It converts industry-standard IFC files to the efficient .frag format used by the ThatOpen ecosystem, loads them into memory, and allows AI assistants to query building elements by category — such as fetching all walls, doors, or windows with their attributes and relationships. It is aimed at architects, engineers, and BIM developers who want to query building data through natural language.
Prerequisites
- Node.js 18 or higher with npm or pnpm
- tsx installed globally (npm install -g tsx) for running TypeScript directly
- IFC files in a format compatible with the web-ifc library
- Claude Desktop or another MCP-compatible client
Clone the repository
Clone the openbim-mcp repository which contains the Fragment MCP Server source code.
git clone https://github.com/helenkwok/openbim-mcp.git
cd openbim-mcpInstall dependencies
Install all required packages including the MCP SDK, ThatOpen fragments library, web-ifc, and zod for schema validation.
pnpm installInstall tsx globally
The server runs as a TypeScript file directly using tsx, which must be installed globally for the MCP client to launch it.
npm install -g tsxConfigure your MCP client
Add the server to your Claude Desktop configuration. Replace /path/to/openbim-mcp with the actual path where you cloned the repository.
{
"mcpServers": {
"bim": {
"command": "npx",
"args": ["-y", "tsx", "/path/to/openbim-mcp/main.ts"]
}
}
}Convert and query a BIM file
After restarting Claude Desktop, you can ask it to convert an IFC file to fragment format, load it, and then query elements by category. The workflow runs as three sequential tool calls.
Fragment MCP Server Examples
Client configuration
Claude Desktop configuration to launch the Fragment MCP Server using tsx to run the TypeScript entry point directly.
{
"mcpServers": {
"bim": {
"command": "npx",
"args": ["-y", "tsx", "/path/to/openbim-mcp/main.ts"]
}
}
}Prompts to try
Example prompts for converting IFC files and querying building data by category using the three available tools.
- "Convert the file /home/user/building.ifc to fragment format and save it to /home/user/building.frag"
- "Load the fragment file at /home/user/building.frag into memory"
- "Fetch all walls from the loaded BIM model with their attributes"
- "Get all doors and windows in the building with their dimensions and locations"
- "List all structural elements in the model by IFC category"Troubleshooting Fragment MCP Server
tsx command not found when MCP client tries to start the server
Install tsx globally with npm install -g tsx and verify with tsx --version. If you are using a version manager like nvm, ensure the globally installed tsx is on the PATH used by your MCP client process.
IFC file fails to convert or throws parsing errors
The server uses the web-ifc library for parsing. Ensure your IFC file is a valid IFC2x3 or IFC4 format. Very large IFC files may require increased Node.js memory: set NODE_OPTIONS=--max-old-space-size=4096 in the server's env block.
fetch-elements-of-category returns empty results
You must call convert-ifc-to-frag first, then load-frag to load the converted file into memory before querying categories. The three tools must be called in sequence: convert, load, then fetch.
Frequently Asked Questions about Fragment MCP Server
What is Fragment MCP Server?
Fragment MCP Server is a Model Context Protocol (MCP) server that 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. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Fragment MCP Server?
Follow the installation instructions on the Fragment MCP Server GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Fragment MCP Server?
Fragment MCP Server works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Fragment MCP Server free to use?
Yes, Fragment MCP Server is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Fragment MCP Server Alternatives — Similar Developer Tools Servers
Looking for alternatives to Fragment MCP Server? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Fragment MCP Server in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Fragment MCP Server?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.