BULC Building Designer

AI-powered building design automation for Claude Desktop

Features • Installation • Usage • Examples • Privacy

Overview

BULC Building Designer is a Model Context Protocol (MCP) server that connects Claude Desktop to the BULC fire simulation software. It enables natural language building design - simply describe what you want, and Claude will create rooms, walls, and multi-story structures automatically.

Features

• Natural Language Design: Create buildings by describing them in plain language
• Room Creation: Rectangular and polygon-shaped rooms
• Wall Management: Individual walls or rectangular enclosures
• Multi-Level Support: Design multi-story buildings with ease
• Spatial Awareness: AI understands relative positions ("next to the living room")
• Undo/Redo: Full support for undoing and redoing operations
• Bilingual: Works in English and Korean

Installation

Prerequisites

1. BULC Application: Download from [Meteor Simulation]([https://www.msimul.com]
2. Node.js: Version 16.0.0 or higher
3. Claude Desktop: Latest version

Setup

1. Clone this repository:

git clone https://github.com/meteor-simulation/bulc-mcp-server.git
cd bulc-mcp-server

2. Install dependencies:

npm install

3. Build the server:

npm run build

4. Configure Claude Desktop:

Add to your claude_desktop_config.json:

Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "bulc": {
      "command": "node",
      "args": ["<path-to-repo>/build/index.js"],
      "env": {
        "BULC_PORT": "19840"
      }
    }
  }
}

5. Restart Claude Desktop

Usage

1. Start BULC Application first

   • You should see [BULC-MCP] Server started on port 19840 in the console

2. Open Claude Desktop

   • The MCP server will connect automatically

3. Start Designing

   • Ask Claude to create rooms, walls, and buildings

Examples

Example 1: Create a Simple Room

Create a 5m x 4m living room

Claude will:

1. Convert 5m x 4m to 500cm x 400cm
2. Create a room at position (0, 0)
3. Name it "Living Room"

Example 2: Add an Adjacent Room

Add a 3m x 3m bedroom to the right of the living room

Claude will:

1. Query the current spatial layout
2. Find the living room's position
3. Calculate the new room's position (adjacent to the right)
4. Create the bedroom

Example 3: Create Walls Around a Room

Create walls around the living room

Claude will:

1. Get the living room's dimensions
2. Create 4 connected walls forming a rectangular enclosure

Example 4: Multi-Story Building

Create a 2-story house:
- Ground floor: Living room (6m x 5m), Kitchen (4m x 4m)
- First floor: 2 bedrooms (4m x 4m each)

Claude will:

1. Create the ground floor level
2. Add living room and kitchen
3. Create the first floor level
4. Add two bedrooms

Example 5: Check Current Layout

Show me the current room layout

Claude will display all rooms with their positions and dimensions.

Available Tools

Query Tools (Read-Only)

Creation Tools

Modification Tools

Utility Tools

Coordinate System

        Z+ (elevation/height)
        │
        │   Y+ (north)
        │  /
        └──────► X+ (east)
      (0,0,0)

Unit: centimeters (cm)
1m = 100cm

Configuration

Environment Variables

Privacy Policy

See PRIVACY_POLICY.md

Summary: This extension operates entirely locally. No data is collected, transmitted, or stored externally. All building designs remain on your local machine.

Support

• Issues: GitHub Issues
• Email: support@meteor-simulation.com
• Website: meteor-simulation.com

License

MIT License - see LICENSE

About

Developed by Meteor Simulation Inc.

BULC (Building Utility for Life-safety Calculations) is a fire dynamics simulator with evacuation analysis capabilities, built on SweetHome3D.

Made with ❤️ for architects, fire safety engineers, and building designers

BULC 빌딩 디자이너 (한국어)

Claude Desktop을 위한 AI 기반 건물 설계 자동화

개요 • 기능 • 설치 • 사용법 • 예시

개요

BULC 빌딩 디자이너는 Claude Desktop과 BULC 화재 시뮬레이션 소프트웨어를 연결하는 MCP(Model Context Protocol) 서버입니다. 자연어로 건물 설계가 가능합니다 - 원하는 것을 설명하면 Claude가 방, 벽, 다층 구조물을 자동으로 생성합니다.

기능

• 자연어 설계: 일반 언어로 건물 설계 가능
• 방 생성: 직사각형 및 다각형 모양의 방
• 벽 관리: 개별 벽 또는 사각형 테두리 벽
• 다층 지원: 다층 건물 설계 용이
• 공간 인식: AI가 상대 위치 이해 ("거실 옆에")
• 실행 취소/다시 실행: 작업 취소 및 재실행 지원
• 이중 언어: 영어와 한국어 지원

설치 방법

사전 요구사항

1. BULC 애플리케이션: Meteor Simulation에서 다운로드
2. Node.js: 버전 16.0.0 이상
3. Claude Desktop: 최신 버전

설정

1. 저장소 클론:

git clone https://github.com/meteor-simulation/bulc-mcp-server.git
cd bulc-mcp-server

2. 종속성 설치:

npm install

3. 서버 빌드:

npm run build

4. Claude Desktop 설정:

claude_desktop_config.json 파일에 추가:

Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "bulc": {
      "command": "node",
      "args": ["<저장소-경로>/build/index.js"],
      "env": {
        "BULC_PORT": "19840"
      }
    }
  }
}

5. Claude Desktop 재시작

사용 방법

1. BULC 애플리케이션 먼저 실행

   • 콘솔에 [BULC-MCP] Server started on port 19840 메시지 확인

2. Claude Desktop 열기

   • MCP 서버가 자동으로 연결됨

3. 설계 시작

   • Claude에게 방, 벽, 건물 생성 요청

예시

예시 1: 간단한 방 생성

5m x 4m 거실을 만들어줘

Claude가 수행:

1. 5m x 4m을 500cm x 400cm으로 변환
2. 위치 (0, 0)에 방 생성
3. "거실"로 이름 지정

예시 2: 인접한 방 추가

거실 오른쪽에 3m x 3m 침실을 추가해줘

Claude가 수행:

1. 현재 공간 레이아웃 조회
2. 거실 위치 찾기
3. 새 방의 위치 계산 (오른쪽에 인접)
4. 침실 생성

예시 3: 방 주위에 벽 생성

거실 주변에 벽을 만들어줘

Claude가 수행:

1. 거실의 크기 조회
2. 사각형 테두리를 형성하는 4개의 연결된 벽 생성

예시 4: 다층 건물

2층짜리 집을 만들어줘:
- 1층: 거실 (6m x 5m), 주방 (4m x 4m)
- 2층: 침실 2개 (각 4m x 4m)

Claude가 수행:

1. 1층 레벨 생성
2. 거실과 주방 추가
3. 2층 레벨 생성
4. 침실 2개 추가

예시 5: 현재 레이아웃 확인

현재 방 레이아웃을 보여줘

Claude가 모든 방의 위치와 크기를 표시합니다.

사용 가능한 도구

조회 도구 (읽기 전용)

생성 도구

수정 도구

유틸리티 도구

좌표계

        Z+ (높이/고도)
        │
        │   Y+ (북쪽)
        │  /
        └──────► X+ (동쪽)
      (0,0,0)

단위: 센티미터 (cm)
1m = 100cm

설정

환경 변수

개인정보 보호정책

PRIVACY_POLICY.md 참조

요약: 이 확장 프로그램은 완전히 로컬에서 작동합니다. 데이터가 외부로 수집, 전송 또는 저장되지 않습니다. 모든 건물 설계는 로컬 컴퓨터에 유지됩니다.

지원

• 이슈: GitHub Issues
• 이메일: support@meteor-simulation.com
• 웹사이트: meteor-simulation.com

라이선스

MIT 라이선스 - LICENSE 참조

소개

Meteor Simulation Inc. 개발

BULC (Building Utility for Life-safety Calculations)는 SweetHome3D 기반의 피난 분석 기능을 갖춘 화재 역학 시뮬레이터입니다.

건축가, 소방 안전 엔지니어, 건물 설계자를 위해 ❤️로 제작