vn-autocad-claude

🇻🇳 Tiếng Việt: đọc hướng dẫn đầy đủ tại README.vi.md.

An MCP server that lets Claude (Claude Code & Claude Desktop) control AutoCAD — draw, edit, query, layers, blocks, annotations, screenshots, plot to PDF — using plain language. Works with full AutoCAD and AutoCAD LT 2024+ on Windows, and runs headless (no AutoCAD needed) on macOS/Linux via the ezdxf backend.

This is a Vietnamese-friendly fork of puran-water/autocad-mcp (MIT). See NOTICE for the list of changes. Maintained by @andyluu98.

AUTOCAD_MCP_BACKEND=auto (default) picks File IPC when an AutoCAD window is found, otherwise falls back to headless ezdxf.

On macOS AutoCAD does not expose AutoLISP/COM, so only the ezdxf backend is available there. That is enough to generate and edit .dxf drawings from Claude.

• Python 3.10+
• uv package manager
• Git
• For the live (File IPC) backend: Windows 10/11 + AutoCAD 2024+ or AutoCAD LT 2024+

git clone https://github.com/andyluu98/vn-autocad-claude.git
cd vn-autocad-claude
./scripts/install.ps1

git clone https://github.com/andyluu98/vn-autocad-claude.git
cd vn-autocad-claude
./scripts/install.sh

The install script runs uv sync and prints the exact MCP config line for your machine.

claude mcp add autocad-mcp --scope user \
  --env AUTOCAD_MCP_BACKEND=auto \
  -- "<ABSOLUTE_PATH>/vn-autocad-claude/.venv/<bin-or-Scripts>/python<.exe>" -m autocad_mcp

• Windows venv python: ...\.venv\Scripts\python.exe
• macOS/Linux venv python: .../.venv/bin/python

The install script prints the full line ready to copy.

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "autocad-mcp": {
      "command": "<ABSOLUTE_PATH>/vn-autocad-claude/.venv/Scripts/python.exe",
      "args": ["-m", "autocad_mcp"],
      "env": { "AUTOCAD_MCP_BACKEND": "auto" }
    }
  }
}

Use .venv/bin/python (no .exe) on macOS/Linux.

1. Open AutoCAD and open/create a drawing.
2. In the command line, type APPLOAD → load lisp-code/mcp_dispatch.lsp. You should see === MCP Dispatch v3.1 loaded ===.
3. To auto-load every time: OPTIONS → Files → Trusted Locations → add the lisp-code folder, then add mcp_dispatch.lsp to the Startup Suite (APPLOAD → Contents).

Quick manual load alternative (paste in the AutoCAD command line):

(load "<ABSOLUTE_PATH>/vn-autocad-claude/lisp-code/mcp_dispatch.lsp")

Restart Claude, then ask it to call system(operation="status"). You should get {"ok": true, "backend": "file_ipc" | "ezdxf"}.

Then try: "draw a circle radius 50 at the origin".

Full playbook (also readable by Claude Code itself): CLAUDE.md.

This repository contains no drawings, no credentials, and no personal data. The IPC working directory is C:\temp (Windows) — your .dwg/.dxf files stay on your machine and are git-ignored. Never commit claude_desktop_config.json or .env.

MIT — see LICENSE. Original copyright retained per the upstream project.