AutoCAD MCP · L4 Engenharia

Conector que liga o Claude (ou outro cliente MCP) ao AutoCAD 2024+ no Windows. Você pergunta pelo chat da IA, ele vai no desenho aberto e responde: conta blocos, lista layers, lê xrefs, cria layers, mede geometria.

Baseado em puran-water/autocad-mcp (licença MIT, mantida neste repositório). Adaptações da L4:

• Reconexão automática quando o AutoCAD é reiniciado (o original guardava o handle da janela antiga e dava timeout silencioso). Ver backends/file_ipc.py, método _dispatch.

• Auto-load do LISP em todo desenho via acaddoc.lsp (sem APPLOAD manual). Template em install/acaddoc.lsp.template.

• Instalação guiada em português por prompt, em install/INSTALAR.md.

Página com vídeo e passo a passo: https://gestaol4.vercel.app/autocad

Requisitos

• Windows 10/11. Não funciona no Mac (AutoCAD LT Mac não tem AutoLISP; backend usa Win32).

• AutoCAD 2024 ou mais novo, full ou LT.

• Python 3.10 a 3.12.

• Um cliente MCP: Claude Desktop (aba Code), Claude Code ou Codex (OpenAI).

Related MCP server: AutoCAD MCP Server

Instalação rápida

1. Baixe o zip em Releases ou clone este repo para C:\Users\<user>\autocad-mcp.

2. Abra a pasta no assistente (Claude Desktop, aba Code, ou Codex) e cole o prompt de install/INSTALAR.md. Ele faz uv sync, registra o servidor autocad, cria o acaddoc.lsp e testa.

3. Abra um DWG. No aviso de segurança do AutoCAD, clique Always Load (só na primeira vez).

Instalação manual (sem assistente):

cd C:\Users\<user>\autocad-mcp
pip install uv
uv sync --python 3.12
# Claude
claude mcp add autocad --scope user --env AUTOCAD_MCP_BACKEND=auto -- .\.venv\Scripts\python.exe -m autocad_mcp
# Codex
codex mcp add autocad --env AUTOCAD_MCP_BACKEND=auto -- .\.venv\Scripts\python.exe -m autocad_mcp

Codex instalado pela Microsoft Store não expõe o comando codex. Nesse caso, acrescente em %USERPROFILE%\.codex\config.toml e reinicie o app:

[mcp_servers.autocad]
command = "C:/Users/<user>/autocad-mcp/.venv/Scripts/python.exe"
args = ["-m", "autocad_mcp"]
env = { AUTOCAD_MCP_BACKEND = "auto" }

Depois copie install/acaddoc.lsp.template para %APPDATA%\Autodesk\AutoCAD <versão>\R<xx>\enu\Support\acaddoc.lsp, trocando __REPO__ pelo caminho da pasta com barras normais (C:/Users/<user>/autocad-mcp).

Como funciona

8 tools MCP (drawing, entity, layer, block, annotation, pid, view, system) sobre stdio. No Windows com AutoCAD aberto, o backend file_ipc escreve um JSON em C:\temp, digita (c:mcp-dispatch) na linha de comando via Win32 (sem roubar foco) e o lisp-code/mcp_dispatch.lsp responde em outro JSON. Sem AutoCAD aberto, cai no backend ezdxf (headless, gera DXF).

Geometria dentro de xrefs exige entrar na definição de bloco via AutoLISP (system → execute_lisp). Visual LISP COM está disponível no AutoCAD full para bounding boxes.

Problemas comuns

E no Revit?

Este conector lê e conta no AutoCAD. Para modelar, parametrizar e quantificar no Revit, a L4 mantém o John: Parts por camada, parâmetros EAP em massa, tabelas de quantitativo, cota corrida, diagnóstico do modelo. Mesmo assistente, mesma forma de pedir.

→ https://gestaol4.vercel.app/john

Licença

MIT. Copyright original de AutoCAD MCP Server Contributors; adaptações © L4 Engenharia. Texto completo em LICENSE.

README original do projeto upstream: README_upstream.md.