AutoCAD MCP Server

Máy chủ MCP cho tự động hóa AutoCAD LT và tạo DXF headless.

Hai backend, một API:

Server cung cấp 8 công cụ chính (drawing, entity, layer, block, annotation, pid, view, system) thông qua MCP stdio transport.

Một MCP client (Claude Desktop, Claude Code, v.v.) có thể kết nối và điều khiển AutoCAD bằng yêu cầu ngôn ngữ tự nhiên.

---

Prerequisites (Backend File IPC)

Yêu cầu:

• Windows 10/11
  (Backend File IPC dùng Win32 API để gửi message tới cửa sổ mà không cần focus)

• AutoCAD LT 2024 trở lên
  AutoLISP được hỗ trợ từ LT 2024 trên Windows.

  ⚠ AutoCAD LT cho Mac không hỗ trợ AutoLISP.

• Python 3.10+
  (Python chạy native trên Windows — không dùng WSL Python)

• uv package manager

Cài đặt:

https://docs.astral.sh/uv/getting-started/installation/

---

💡 Backend ezdxf headless chạy được trên:

• Linux
• macOS
• WSL

và không cần AutoCAD, chỉ dùng để tạo file DXF offline.

---

Quick Start

1. Clone và cài đặt

git clone https://github.com/ks40-academy/autocad-mcp.git
cd autocad-mcp
uv sync

---

2. Load LISP dispatcher trong AutoCAD LT

Mở AutoCAD LT và load file:

mcp_dispatch.lsp

bằng lệnh APPLOAD

Các bước:

1. Gõ APPLOAD trong command line
2. Chọn file

/lisp-code/mcp_dispatch.lsp

3. Nhấn Load

Nếu thành công sẽ thấy:

=== MCP Dispatch v3.1 loaded ===
Ready for commands via (c:mcp-dispatch)

---

💡 Mẹo

Thêm file này vào Startup Suite trong APPLOAD để AutoCAD tự load khi mở bản vẽ.

---

3. Cấu hình MCP client

Ví dụ cấu hình trong:

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" }
    }
  }
}

Lưu ý quan trọng

• command phải trỏ tới Windows Python trong venv
• Không dùng WSL Python

---

Chạy từ WSL

Nếu MCP client chạy trong WSL (ví dụ Claude Code):

khởi động server thông qua cmd.exe

{
  "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. Kiểm tra hoạt động

Từ MCP client gọi:

system(operation="status")

Kết quả:

backend: "file_ipc"

nếu AutoCAD đang chạy

hoặc

backend: "ezdxf"

nếu chạy chế độ headless.

---

Tools

drawing — Quản lý file bản vẽ

| Operation | Mô tả | File IPC | ezdxf |