# 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) — **개발 중** |

## 설치

```bash
# 의존성 설치
uv sync

# AutoCAD LT 연결 시 LISP 로드 (AutoCAD 명령창에서)
(load "C:/path/to/lisp-code/mcp_dispatch.lsp")
```

## 실행

```bash
# 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 LT
```

## Claude Desktop 연결

`claude_desktop_config.json`:

```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 간 겹침·여유 거리
```

## 테스트

```bash
uv run pytest
```