AutoCAD自动化服务

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

<repo>/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ẽ

entity — Quản lý đối tượng

Tạo

• create_line
• create_circle
• create_polyline
• create_rectangle
• create_arc
• create_ellipse
• create_mtext
• create_hatch

Đọc

• list
• count
• get

Chỉnh sửa

• copy
• move
• rotate
• scale
• mirror
• offset*
• array
• fillet*
• chamfer*
• erase

⚠ offset, fillet, chamfer chỉ dùng với File IPC.

layer — Quản lý layer

• list
• create
• set_current
• set_properties
• freeze
• thaw
• lock
• unlock

block — Thao tác block

annotation — Chú thích

• create_text
• create_dimension_linear
• create_dimension_aligned
• create_dimension_angular
• create_dimension_radius
• create_leader

pid — P&ID

Thư viện ký hiệu CTO.

Các lệnh:

• setup_layers
• insert_symbol
• list_symbols
• draw_process_line
• connect_equipment
• add_flow_arrow
• add_equipment_tag
• add_line_number
• insert_valve
• insert_instrument
• insert_pump
• insert_tank

⚠ Cần cài thư viện:

https://www.cadtoolsonline.com/

vào thư mục

C:\PIDv4-CTO\

view — Viewport & Screenshot

File IPC dùng:

PrintWindow (Win32)

Có thể chụp ngay cả khi AutoCAD bị minimize.

ezdxf dùng:

matplotlib render

system — Quản lý server

• status
• health
• get_backend
• runtime
• init
• execute_lisp

execute_lisp

Chạy AutoLISP bất kỳ:

Ví dụ

(+ 1 2)

Gửi:

data: {code: "(+ 1 2)"}

Biến server thành nền tảng automation mở rộng.

Architecture

MCP Client (Claude)
        │
        │ stdio (JSON-RPC)
        ▼
Python MCP Server (autocad_mcp)
        │
        ├── File IPC Backend
        │       │
        │       └── C:/temp/*.json
        │               │
        │               ▼
        │        mcp_dispatch.lsp (AutoCAD)
        │
        └── ezdxf Backend
                │
                ▼
           in-memory DXF

File IPC gửi keystrokes tới AutoCAD bằng:

PostMessageW(WM_CHAR)

Ưu điểm:

• Không cướp focus cửa sổ
• Có thể làm việc ứng dụng khác song song.

Environment Variables

⚠ Nếu đổi:

AUTOCAD_MCP_IPC_DIR

phải sửa luôn biến:

*mcp-ipc-dir*

trong file

mcp_dispatch.lsp

Development

uv sync
uv run pytest tests/ -v

AutoCAD LT AutoLISP Compatibility

AutoLISP được thêm vào AutoCAD LT 2024 (Windows).

What's New v3.1

Các cập nhật chính:

• execute_lisp
• undo / redo
• open drawing
• create drawing reset
• save path
• get_variables fix
• polyline fix
• ESC prefix
• UTF8 fallback
• IPC timeout config
• thread-safe init

License

MIT