sinmb79/Construction-project-master

CivilPlan MCP v2.0.0

한국형 토목·건축 프로젝트 기획을 MCP 도구로 구조화하고 문서·도면·3D 렌더까지 생성하는 서버입니다.

소개

CivilPlan MCP는 자연어 프로젝트 설명을 받아 인허가 검토, 물량 산정, 단가 조회, 투자 문서 작성, SVG/DXF 도면 생성, 3D Bird's-Eye View 렌더링까지 연결하는 20개 MCP 도구를 제공합니다.

주요 흐름은 프로젝트 파싱 → 법적·사업성 검토 → 산출물 생성입니다.

flowchart LR
    A["사용자 요청<br/>Natural-language request"] --> B["civilplan_parse_project"]
    B --> C["법적·기획 분석<br/>legal / planning analysis"]
    B --> D["물량·단가·사업성<br/>quantity / pricing / feasibility"]
    B --> E["문서·도면 생성<br/>docs / drawings"]
    B --> F["3D 렌더 생성<br/>bird's-eye / perspective render"]
    C --> G["MCP 응답 JSON"]
    D --> G
    E --> G
    F --> G

누가 쓰면 좋은가

주요 기능

v2.0.0 변경점

도구 목록

기획·분석 도구

문서·도면 도구

지원 도메인

빠른 시작 가이드

1. 저장소 받기

git clone https://github.com/sinmb79/Construction-project-master.git
cd Construction-project-master
python -m venv.venv

2. 가상환경 활성화와 패키지 설치

# Windows.venv\Scripts\activate

# macOS / Linux
source.venv/bin/activate

python -m pip install -r requirements.txt

3. API 키 설정

.env 예시는 아래와 같습니다.

DATA_GO_KR_API_KEY=
VWORLD_API_KEY=
GEMINI_API_KEY=

4. 서버 실행

python server.py

실행 주소는 http://127.0.0.1:8765/mcp 입니다.

5. MCP 클라이언트 연결

Claude Code

claude mcp add --transport http civilplan http://127.0.0.1:8765/mcp

Claude Desktop

HTTP MCP 서버를 추가한 뒤 Claude Desktop을 재시작하세요.

ChatGPT Developer Mode

cloudflared 예시는 아래와 같습니다.

cloudflared tunnel --url http://127.0.0.1:8765

터널이 만든 HTTPS URL을 ChatGPT 앱 생성 화면에 넣으세요.

기타 MCP 클라이언트

실전 사용 예시

예시 1: 도로 프로젝트 파싱

AI에게 이렇게 말하세요

도로 신설 L=890m B=6m 아스콘 2차선 상하수도 경기도 화성시 2026~2028

호출되는 도구

civilplan_parse_project(
    description="도로 신설 L=890m B=6m 아스콘 2차선 상하수도 경기도 화성시 2026~2028"
)

결과 예시

{
  "project_id": "PRJ-20260404-001",
  "domain": "토목_도로",
  "sub_domains": ["토목_상하수도"],
  "project_type": ["도로", "하수도"],
  "road": {
    "length_m": 890.0,
    "width_m": 6.0,
    "lanes": 2,
    "pavement": "아스콘"
  },
  "region": "경기도",
  "year_start": 2026,
  "year_end": 2028,
  "parsed_confidence": 0.92
}

예시 2: 인허가 절차 확인

AI에게 이렇게 말하세요

경기도 공공 도로 사업(총사업비 10.67억, 연장 890m)에 필요한 인허가를 정리해줘

호출되는 도구

civilplan_get_legal_procedures(
    domain="토목_도로",
    project_type="도로",
    total_cost_billion=10.67,
    road_length_m=890,
    development_area_m2=None,
    region="경기도",
    has_farmland=False,
    has_forest=False,
    has_river=False,
    is_public=True
)

결과 예시

{
  "summary": {
    "total_procedures": 3,
    "mandatory_count": 2,
    "optional_count": 1,
    "estimated_prep_months": 12,
    "critical_path": [
      "도시·군관리계획 결정",
      "개발행위허가",
      "소규모환경영향평가"
    ]
  },
  "timeline_estimate": {
    "인허가완료목표": "착공 18개월 전"
  }
}

예시 3: SVG 도면 생성

AI에게 이렇게 말하세요

위 프로젝트로 개략 평면도 SVG를 만들어줘

호출되는 도구

civilplan_generate_svg_drawing(
    drawing_type="평면도",
    project_spec=project_spec,
    quantities=quantities,
    scale="1:200",
    output_filename="road-plan.svg"
)

결과 예시

{
  "status": "success",
  "file_path": "output/road-plan.svg",
  "drawing_type": "평면도",
  "quantity_sections": ["earthwork", "pavement", "drainage"]
}

예시 4: Bird's-Eye View 렌더 생성

AI에게 이렇게 말하세요

이 도로 사업을 발표용 3D 조감도와 사람 시점 투시도로 만들어줘

호출되는 도구

civilplan_generate_birdseye_view(
    project_summary="경기도 화성시 도로 신설 890m, 폭 6m, 2차선 아스콘 포장, 상하수도 포함",
    project_spec=project_spec,
    svg_drawing="<svg>...</svg>",
    resolution="2K"
)

결과 예시

{
  "status": "success",
  "project_id": "PRJ-20260404-001",
  "model": "gemini-3-pro-image-preview",
  "resolution": "2K",
  "reference_image_path": "output/PRJ-20260404-001_reference.png",
  "birdseye_view": {
    "status": "success",
    "path": "output/PRJ-20260404-001_birdseye.png"
  },
  "perspective_view": {
    "status": "success",
    "path": "output/PRJ-20260404-001_perspective.png"
  }
}

프로젝트 구조

Construction-project-master/
├─ server.py                      # 서버 실행 진입점
├─ setup_keys.py                  # 암호화 키 저장 유틸
├─ requirements.txt               # 런타임 의존성
├─ pyproject.toml                 # 패키지 메타데이터
├─ README.md                      # 사용 가이드
├─ civilplan_mcp/
│  ├─ __init__.py                 # 버전 정보
│  ├─ config.py                   # 설정·경로·API 키 로딩
│  ├─ models.py                   # 도메인 enum
│  ├─ secure_store.py             # DPAPI 키 저장
│  ├─ prompts/
│  │  └─ birdseye_templates.py    # 도메인별 렌더 프롬프트
│  ├─ services/
│  │  └─ gemini_image.py          # Gemini 이미지 래퍼
│  ├─ tools/
│  │  ├─ birdseye_generator.py    # 3D 렌더 도구
│  │  ├─ drawing_generator.py     # SVG 도면 생성
│  │  ├─ dxf_generator.py         # DXF 도면 생성
│  │  └─...