Skip to main content
Glama

Construct-CM-Bridge (Construct-MCP-Korea)

건설사업관리(CM) 외부 AI 실무 연동 및 업무 자동화 오픈 프레임워크
실시간 국가법령·KCSC 건설기준 연동 및 HWPX/도면 3자 수치 교차검증 기반 FastMCP 엔진

Python 3.10+ FastMCP License: MIT Tests: 85 Passed


📌 프로젝트 소개 (Introduction)

Construct-CM-Bridge는 건설사업관리(CM) 현장 감리단의 제출도서(시공계획서, 구조/수치계산서, 발주처 특기시방서, 기성내역서 등)를 로컬 격리 환경에서 안전하게 파싱하고, 공식 국가법령(법제처) 및 KCSC 건설기준(국토부)과 대조하여 3자 수치 교차 검증을 수행하는 오픈소스 FastMCP 서버입니다.

기존 중앙 집중형 사내 AI(RAG 방식)가 해결하지 못했던 "현장별 발주처 특기시방 미반영", "빈번한 현장 설계변경 추적 부재", "엑셀 수식 및 역학 계산 불가(LLM 텍스트 환각)" 문제를 극복하여, 각 현장 기술인 개개인을 보좌하는 1:1 맞춤형 전담 비서(Personalized CM Agent) 체계를 제공합니다.

안내: 자동 생성 결과는 근거 발견(Source Anchoring)과 산술 선별을 제공하는 검토 초안이며, 승인·법적 적합 판정은 책임기술인의 원문 및 현장 확인이 필요합니다.


Related MCP server: KCSC Standard MCP

🌟 주요 특징 (Key Features)

  1. 실시간 국가법령 및 KCSC 건설기준 연동 (Module 1)

    • 국가법령정보센터(law.go.kr) 및 국가건설기준센터(kcsc.re.kr) 실시간 REST API 연동.

    • API 자격증명이 없거나 조회에 실패하면 번들된 오프라인 샘플을 사용하고, 응답의 source 필드로 실시간/로컬 출처를 구분.

  2. 로컬 격리 샌드박스 & HWPX 다차원 문서 파서 (Module 2)

    • 사내 민감 도면·시방 데이터 외부 유출 제로 (secure_local_data/ 격리).

    • HWPX(한글 표준 XML) 내 본문 단락 및 hp:tbl 표 데이터를 마크다운 표로 구조화 파싱.

    • Excel(.xlsx, .xlsm), Word(.docx), PowerPoint(.pptx), PDF(.pdf), HWPX, TXT/MD/JSON 텍스트 추출 지원.

  3. 5대 공종 다분야 수치 검산 엔진 (Module 3)

    • 토목/구조: 일반 허용치 안전율, 버팀보 좌굴 안전율, 그라운드앵커 인장 안전율.

    • 기계/설비: 펌프 양정 여유율, 필요 환기량.

    • 소방: 옥내소화전 유효저수량, 스프링클러 헤드 토출량($K\sqrt{10P}$).

    • 전기/통신: 3상 선로 전압강하율, 변압기 부하율.

    • 건축: 외벽 열관류율($U$-value).

    • Python AST 기반 안전 커스텀 수식 검산 지원.

  4. CM 표준 감리/기술검토의견서 자동 생성

    • 근거 대조표와 검산 상세를 포함한 .docx.md 검토 초안 생성. 입력 근거가 없으면 REVIEW_REQUIRED로 표시.

  5. 기존 사내 AI 시스템(FastAPI/RAG) 즉시 이식성

    • 코어 모듈(core/)이 FastMCP와 완전히 분리되어 있어 사내 FastAPI 백엔드에 코드 수정 없이 Action Engine으로 바로 이식 가능.


📂 프로젝트 디렉토리 구조

construct-cm-bridge/
├── pyproject.toml                     # 프로젝트 종속성 및 메타데이터
├── requirements.txt                   # pip 설치용 종속성 목록
├── README.md                          # 프로젝트 안내서
├── ARCHITECTURE.md                    # 제안서용 상세 아키텍처 다이어그램 및 시퀀스
├── SYSTEM_PROMPT.md                   # AI 클라이언트용 시스템 프롬프트 명세
├── RULES.md                           # Zero-Hallucination 하네스 룰
├── mcp_configs/                       # MCP 클라이언트 연동 설정 스니펫
│   ├── claude_desktop_config.json
│   ├── cursor_mcp_config.json
│   └── antigravity_mcp_config.json
├── secure_local_data/                 # 로컬 보안 격리 폴더 (샘플 입력 및 출력 리포트)
│   ├── sample_과업지시서_특기시방.hwpx
│   ├── sample_가설흙막이_구조계산서.xlsx
│   ├── sample_소방_소화수조및펌프계산서.xlsx
│   ├── sample_전기_전압강하및변압기계산서.xlsx
│   └── sample_건축_단열및시공계획서.docx
├── src/construct_cm_bridge/
│   ├── cli.py                         # CLI 도구 (serve, list, parse, check-bundle, law, kcsc, demo)
│   ├── server.py                      # FastMCP 서버 및 31개 도구 정의
│   ├── core/                          # 독립 코어 라이브러리 (사내 AI 이식용)
│   │   ├── openapi_client.py          # 국가법령정보 & KCSC API 연동
│   │   ├── doc_parser.py              # HWPX, XLSX, DOCX, PDF 파서
│   │   ├── batch_cross_checker.py     # 다중 도서 일괄 교차 검토 및 불일치 전수검사기
│   │   ├── formula_engine.py          # 5대 분야별 공식 레지스트리 및 AST 검산기
│   │   └── docx_exporter.py           # CM 표준 서식 Word/MD 생성기
│   └── data_cache/                    # 오프라인/Fallback 데이터셋
└── tests/                             # 단위 및 E2E 테스트 슈트

🚀 빠른 시작 (Quick Start)

1. 환경 설정 및 종속성 설치

git clone https://github.com/SkillfulBasher1/construct-cm-bridge.git
cd construct-cm-bridge

pip install -r requirements.txt

실시간 조회를 사용하려면 LAW_API_OCKCSC_API_KEY를 설정합니다. 미설정 시 로컬 샘플 데이터만 사용합니다.

2. 다중 제출도서 일괄 교차 전수검사 (Batch Cross-Check)

python -m construct_cm_bridge.cli check-bundle sample_과업지시서_특기시방.hwpx sample_가설흙막이_구조계산서.xlsx

3. 종합 데모(3대 시나리오 교차 검토 및 감리의견서 생성) 실행

python -m construct_cm_bridge.cli demo

4. CLI 개별 기능 테스트

# 로컬 보안 폴더 파일 목록 조회
python -m construct_cm_bridge.cli list

# HWPX 문서 파싱
python -m construct_cm_bridge.cli parse sample_과업지시서_특기시방.hwpx

# 국가법령 검색
python -m construct_cm_bridge.cli law "건설기술 진흥법" --article 62

# KCSC 건설기준 검색
python -m construct_cm_bridge.cli kcsc "KDS 21 30 00"

🔌 MCP 클라이언트 연동 (Claude Desktop / Cursor / VS Code)

Claude Desktop 연동

%APPDATA%\Claude\claude_desktop_config.json에 다음 설정을 추가합니다:

{
  "mcpServers": {
    "construct-cm-bridge": {
      "command": "python",
      "args": [
        "-m",
        "construct_cm_bridge.cli",
        "serve"
      ],
      "env": {
        "PYTHONPATH": "c:\\Projects\\construct-cm-bridge\\src"
      }
    }
  }
}

🧪 테스트 실행

python -m pytest tests/ -v

📄 License

MIT License. Copyright (c) 2026 Construct-CM-Bridge Contributors.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

No tool schema history has been recorded yet.

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

Latest Blog Posts

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/SkillfulBasher1/construct-cm-bridge'

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