AutoCAD LT 자동화 및 헤드리스 DXF 생성을 위한 MCP 서버입니다.

두 개의 백엔드, 하나의 API:

서버는 MCP 표준 전송을 통해 8개의 통합 도구(drawing, entity, layer, block, annotation, pid, view, system])를 노출합니다. MCP 클라이언트(Claude Desktop, Claude Code 등)가 자연어 요청을 통해 AutoCAD를 연결하고 구동합니다.

전제 조건 (파일 IPC 백엔드)

• Windows 10/11 (파일 IPC 백엔드는 포커스 프리 윈도우 메시징을 위해 Win32 API를 사용합니다)
• AutoCAD LT 2024 또는 그 이후 — AutoLISP 지원은 Windows 버전 LT 2024에서 추가되었습니다. Mac용 AutoCAD LT는 존재하지만 ** AutoLISP를 지원하지 않습니다.
• Python 3.10+ (Windows 네이티브 — WSL 파이썬 아님)
• UV 패키지 관리자 (설치 가이드)

ezdxf 헤드리스 백엔드는 AutoCAD가 설치되지 않아도 오프라인 DXF 생성을 위해 Linux, macOS, WSL 등 모든 플랫폼에서 작동합니다.

퀵 스타트

1. 복제 및 설치

2.

AutoCAD MCP Server

MCP server for AutoCAD LT automation and headless DXF generation.

Two backends, one API:

The server exposes 8 consolidated tools (drawing, entity, layer, block, annotation, pid, view, system) over the MCP stdio transport. An MCP client (Claude Desktop, Claude Code, etc.) connects and drives AutoCAD through natural-language requests.

Prerequisites (File IPC backend)

• Windows 10/11 (the File IPC backend uses Win32 APIs for focus-free window messaging)
• AutoCAD LT 2024 or newer — AutoLISP support was added in LT 2024 for Windows. AutoCAD LT for Mac exists but does not support AutoLISP.
• Python 3.10+ (Windows native — not WSL Python)
• uv package manager (install guide)

The ezdxf headless backend works on any platform (Linux, macOS, WSL) for offline DXF generation without AutoCAD installed.

Quick Start

1. Clone and install

git clone https://github.com/puran-water/autocad-mcp.git
cd autocad-mcp
uv sync

2. Load the LISP dispatcher in AutoCAD LT

Open AutoCAD LT and load mcp_dispatch.lsp using APPLOAD:

1. Type APPLOAD in the AutoCAD command line
2. Browse to /lisp-code/mcp_dispatch.lsp
3. Click Load
4. You should see: === MCP Dispatch v3.1 loaded === and Ready for commands via (c:mcp-dispatch)

Tip: Add the file to your AutoCAD Startup Suite (in the APPLOAD dialog) so it loads automatically with every drawing.

3. Configure your MCP client

Add to your MCP client configuration (e.g. Claude Desktop claude_desktop_config.json):

{
  "mcpServers": {
    "autocad-mcp": {
      "command": "C:\\path\\to\\autocad-mcp\\.venv\\Scripts\\python.exe",
      "args": ["-m", "autocad_mcp"],
      "env": { "AUTOCAD_MCP_BACKEND": "auto" }
    }
  }
}

Key points:

• The command must point to the Windows Python inside the project venv (not WSL python).
• AUTOCAD_MCP_BACKEND can be auto (default — tries File IPC, falls back to ezdxf), file_ipc (requires AutoCAD), or ezdxf (headless only).

Running from WSL

If your MCP client runs in WSL (e.g. Claude Code), launch the server through cmd.exe so it runs as a native Windows process:

{
  "mcpServers": {
    "autocad-mcp": {
      "type": "stdio",
      "command": "cmd.exe",
      "args": ["/d", "/s", "/c", "cd /d C:\\path\\to\\autocad-mcp && .venv\\Scripts\\python.exe -m autocad_mcp"],
      "env": { "AUTOCAD_MCP_BACKEND": "auto" }
    }
  }
}

4. Verify

From your MCP client, call:

system(operation="status")