autocad-mcp
AutoCAD / AutoCAD LT 자동화를 위한 MCP 서버.
Claude 같은 LLM이 자연어로 AutoCAD 도면을 생성·편집할 수 있도록 MCP 프로토콜로 연결합니다.
특징
- AutoCAD LT 지원 — COM/ActiveX 없이 LISP + 파일 IPC 방식으로 LT에서도 동작
- 헤드리스 모드 — ezdxf 백엔드로 AutoCAD 없이 DXF 파일 직접 생성
- Validation Layer — 도면 실행 전 기하·의존성·간섭 검증 (AssemblyValidator로 shape 간 충돌 사전 차단)
- P&ID 지원 — 공정 배관 계장도 심볼·라인 삽입
아키텍처
LLM (Claude)
│ MCP tool call
▼
MCP Server (server.py) ← 8개 툴 + validate
│
├─ Validation Layer ← 실행 전 검증 (geometry / dependency / assembly)
│
├─ File IPC Backend ← AutoCAD LT: JSON 파일 → LISP dispatch → 결과 파일
└─ ezdxf Backend ← 헤드리스: Python에서 DXF 직접 생성MCP 툴 목록
| 툴 | 설명 | |---|---| | drawing | 파일 생성·열기·저장·PDF 출력 | | layer | 레이어 생성·속성·잠금·동결 | | entity | 도형 생성 (선·원·호·사각형·폴리라인 등) 및 수정 | | block | 블록 삽입·속성 조회·수정 | | annotation | 치수·지시선 | | pid | P&ID 심볼·배관 라인 | | view | 줌·화면 제어 | | system | 핑·백엔드 전환·스크린샷 | | validate | 실행 전 Validation (geometry / dependency / assembly) — 개발 중 |
설치
# 의존성 설치
uv sync
# AutoCAD LT 연결 시 LISP 로드 (AutoCAD 명령창에서)
(load "C:/path/to/lisp-code/mcp_dispatch.lsp")실행
# MCP 서버 시작
uv run python -m autocad_mcp
# 백엔드 선택 (환경변수)
AUTOCAD_MCP_BACKEND=ezdxf uv run python -m autocad_mcp # 헤드리스
AUTOCAD_MCP_BACKEND=file_ipc uv run python -m autocad_mcp # AutoCAD LTClaude Desktop 연결
claude_desktop_config.json:
{
"mcpServers": {
"autocad-mcp": {
"command": "...python.exe",
"args": ["-m", "autocad_mcp"],
"env": {
"AUTOCAD_MCP_BACKEND": "file_ipc"
}
}
}
}AutoCAD LT IPC 동작 방식
AutoCAD LT는 COM 자동화를 지원하지 않으므로 파일 기반 IPC를 사용합니다.
Python → C:/temp/autocad_mcp_cmd_{id}.json 작성
→ "(c:mcp-dispatch)" 입력 전송
→ AutoCAD LISP이 명령 실행
→ C:/temp/autocad_mcp_result_{id}.json 작성
→ Python이 결과 파일 폴링Validation Layer
현재 개발 중입니다. API와 동작 방식은 변경될 수 있습니다.
validate(operation="pipeline", data={"intents": [...]})
│
├─ Phase 1: shape별 개별 검증
│ ├─ GeometryValidator — 치수 범위, 최소 반지름
│ └─ DependencyValidator — layer → entity 순서 (DFA)
│
└─ Phase 2: 전체 교차 간섭 검증
└─ AssemblyValidator — shape 간 겹침·여유 거리테스트
uv run pytest
