AutoCAD MCP Server

Estado / Status: En proceso de mejora de rendimiento — work in progress. Las funcionalidades principales funcionan, pero se siguen optimizando la velocidad y estabilidad.

Servidor MCP (Model Context Protocol) que conecta Claude (u otro cliente compatible con MCP) directamente con AutoCAD, permitiendo generar planos arquitectónicos, dibujar geometría y exportar archivos DXF con solo describir lo que necesitas en lenguaje natural.

An MCP server that bridges Claude (or any MCP-compatible AI) with AutoCAD, enabling you to generate architectural floor plans, draw geometry, and export DXF files just by describing what you need in natural language.

¿Qué hace? / What does it do?

Claude / AI  →  "Diseña una vivienda de 120 m² para 4 personas"
                       │
                       ▼
              MCP AutoCAD Server
                       │
           ┌───────────┴────────────┐
           ▼                        ▼
    Exporta DXF              Dibuja en AutoCAD
 (sin AutoCAD abierto)     (COM — Windows, opcional)
~/Documents/AutocadMCP/output/

• Interpreta un brief arquitectónico en lenguaje natural

• Aplica reglas de construcción (mínimos RNE Perú / normativa general)

• Genera geometría (muros, puertas, ventanas, mobiliario)

• Exporta a DXF (compatible con AutoCAD, Revit, FreeCAD, cualquier visor CAD)

• Controla AutoCAD directamente via COM (Windows, AutoCAD completo requerido)

Related MCP server: freecad-mcp

Requisitos / Requirements

La exportación a DXF funciona sin AutoCAD instalado. AutoCAD solo es necesario para dibujar directamente en él (herramientas draw_*, batch_execute, etc.).

Instalación / Installation

# 1. Clona el repositorio
git clone https://github.com/dtocjao/MCP---Autocad.git
cd MCP---Autocad

# 2. Crea el entorno virtual
python -m venv .venv
.\.venv\Scripts\Activate.ps1

# 3. Instala dependencias
pip install -e .

Dependencias instaladas automáticamente:

• mcp[cli] — protocolo MCP (FastMCP)

• pywin32 — integración COM con AutoCAD (Windows)

• ezdxf — generación de archivos DXF

Cómo ejecutar / How to run

Opción A — Claude Desktop (modo local, stdio)

Edita el archivo de configuración de Claude Desktop:

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "autocad": {
      "command": "C:\\RUTA\\AL\\PROYECTO\\MCP---Autocad\\.venv\\Scripts\\python.exe",
      "args": ["-m", "autocad_mcp.server"]
    }
  }
}

Reemplaza C:\\RUTA\\AL\\PROYECTO\\ con la ruta real donde clonaste el repo.
Reinicia Claude Desktop. El servidor autocad aparecerá en la lista de herramientas.

Ver claude_desktop_config.example.json como referencia.

Opción B — Claude.ai web (modo HTTP remoto con ngrok)

Claude en la web requiere una URL HTTPS pública. Sigue estos pasos:

1. Abre AutoCAD (si vas a usar la integración directa con AutoCAD).

2. Inicia el servidor HTTP:

scripts\start_for_claude.bat

O con PowerShell:

powershell -ExecutionPolicy Bypass -File .\scripts\start_for_claude.ps1

Esto levanta el servidor en el puerto 8765.

3. Expón el puerto con ngrok (en otra terminal):

ngrok http 8765

Descarga ngrok en ngrok.com/download si no lo tienes.

4. Copia la URL HTTPS que muestra ngrok, por ejemplo:

https://a1b2c3d4.ngrok-free.app

5. En Claude.ai → Añadir conector personalizado:

6. Prueba con: "Usa draw_bedroom_plan para crear un dormitorio de 20 m²"

La URL de ngrok cambia cada vez que lo reinicias (plan gratuito). Elimina y vuelve a añadir el conector si cambia.

Alternativa: Cloudflare Tunnel

cloudflared tunnel --url http://localhost:8765

Usa la URL pública con el sufijo /mcp.

Herramientas disponibles / Available tools

Arquitectónicas (generan DXF + pueden dibujar en AutoCAD)

CAD directas (AutoCAD COM, requiere AutoCAD abierto)

Esquema de proyecto arquitectónico (Niveles 1–8)

Claude puede enviar JSON desde lo más simple hasta un plano profesional completo:

Ejemplo mínimo (Nivel 1):

{
  "title": "Dormitorio",
  "rooms": [{"name": "Dormitorio", "width": 3.4, "length": 4.0, "area": 13.6}]
}

Ejemplo con normativa peruana RNE (Nivel 3+):

{
  "projectType": "vivienda_multifamiliar",
  "code": {"country": "PE", "municipality": "Lima", "rne": true},
  "layers": {"walls": "ARQ_MUROS", "doors": "ARQ_PUERTAS"},
  "architecturalIntent": {"includeTitleBlock": true, "includeGrid": true}
}

Ejemplos de uso con Claude / Usage examples

"Conecta con AutoCAD y dime qué dibujo tengo abierto"
"Diseña una vivienda de 120 m² para una familia de 4 personas"
"Crea un dormitorio suite de 5x4 metros con cama king y baño"
"Dibuja un rectángulo de 0,0 a 100,50 en la capa Paredes"
"Valida este plano contra las normas mínimas de construcción"
"Exporta el plano a DXF y guárdalo"

Estructura del proyecto / Project structure

autocad_mcp/
├── server.py               # Punto de entrada MCP (stdio y HTTP)
├── autocad_client.py       # Cliente COM de AutoCAD (pywin32)
├── floor_plan.py           # Generador de planos (legacy)
└── architecture/
    ├── pipeline.py         # Orquestación end-to-end
    ├── project_builder.py  # JSON → geometría + validación
    ├── project_schema.py   # Modelo ArchitecturalProject (Niveles 1–8)
    ├── dxf_export.py       # Exportador DXF (capas, cotas, ejes, cartela)
    ├── rules.py            # Reglas mínimas, RNE Perú
    ├── layout.py           # Distribución automática de estancias
    ├── wall_engine.py      # Motor de muros
    ├── cad_model.py        # Modelo de datos CAD
    └── ...
scripts/
├── start_for_claude.bat    # Inicia servidor HTTP (Windows CMD)
└── start_for_claude.ps1    # Inicia servidor HTTP (PowerShell)

Solución de problemas / Troubleshooting

Estado del proyecto / Project status

Este proyecto está en proceso de mejora activa. Las funcionalidades principales (exportación DXF, integración COM, herramientas arquitectónicas) ya funcionan. Se está trabajando en:

• Mejorar la velocidad de la integración COM con AutoCAD

• Optimizar la generación de geometría compleja

• Ampliar soporte de normativas internacionales

• Mejorar compatibilidad con Cursor y otros clientes MCP

Contribuciones y reportes de bugs son bienvenidos.

Licencia / License

MIT