Agente AutoCAD 2021 MCP (v1.4.9)

Agente de ingeniería e integración CAD basado en el protocolo Model Context Protocol (MCP) y FastMCP, diseñado para operar sobre AutoCAD 2021 (English) en entornos profesionales (Casa / Oficina) de manera determinista, segura y de alto rendimiento.

🚀 Arquitectura Headless-First

El agente prioriza la ejecución Headless a través de accoreconsole.exe de AutoCAD:

• Ultrarrápido: Tiempos de respuesta de 1 a 4 segundos por transacción, sin sobrecarga gráfica de GUI.

• Transaccional y Seguro: Realiza copias de respaldo secuenciales automáticas (<Dibujo>-Legacy-0.dwg, -Legacy-1.dwg), garantizando atomicidad con reversión automática en caso de error.

• Circuit Breaker Anti-Inyección: Validación estructural AST y bloqueo estricto de llamadas peligrosas al sistema operativo (startapp, _.SHELL, vl-file-*, macros VBA/ARX o inyección en comandos).

• Aislamiento de Datos No Confiables: Todo texto, capa o atributo recuperado del DWG se entrega sanitizado dentro de bloques <untrusted_cad_data>.

• Compatibilidad de Coordenadas: Transformación determinista de coordenadas OCS (Object Coordinate System) a WCS (World Coordinate System) respetando extrusiones (DXF 210) y UCS del usuario.

flowchart LR
    IDE["IDE / Agente LLM<br/>(Antigravity, Codex, Claude)"] <-->|MCP Protocol (stdio)| Server["mcp-autocad/server.py<br/>(FastMCP)"]
    Server <-->|Headless Console| Accore["accoreconsole.exe<br/>(AutoCAD 2021)"]
    Server <-->|Live Fallback (COM)| AcadGUI["acad.exe (GUI)"]
    Accore <-->|Pure AutoLISP / entmake| DWG["Archivos .DWG"]

Related MCP server: AutoCAD MCP

🛠️ Requisitos del Sistema

1. Sistema Operativo: Windows 10 o Windows 11 (64-bit).

2. AutoCAD: AutoCAD 2021 en inglés (con accoreconsole.exe en C:\Program Files\Autodesk\AutoCAD 2021\accoreconsole.exe).

3. Python: Python 3.10 o superior añadido al PATH del sistema.

4. Entornos MCP compatibles: Google Antigravity, OpenAI Codex o Claude Desktop.

📦 Instalación Rápida

Opción 1: Asistente Visual (Recomendada)

Haz doble clic en:

instalar.bat

El instalador con interfaz gráfica (installer_gui.ps1):

1. Verificará la instalación de AutoCAD 2021 y Python.

2. Creará el entorno virtual (.venv) e instalará las dependencias requeridas (mcp, pywin32, openpyxl, pypdfium2, Pillow).

3. Creará los enlaces de Skills globales para Google Antigravity y OpenAI Codex.

4. Registrará el servidor MCP en los entornos seleccionados (mcp_config.json, config.toml, claude_desktop_config.json).

Opción 2: Instalación por Línea de Comandos

Ejecuta en una terminal de comandos (CMD o PowerShell):

setup_local.bat

🔧 Catálogo de Herramientas MCP (16 Herramientas)

⚙️ Variables de Entorno

🧪 Pruebas y Validación

Para ejecutar la suite exhaustiva de 15 pruebas unitarias y de integración:

python run_tests_v1.4.9.py

La suite valida:

• Validez RFC 8259 de la especificación JSON.

• Integridad AST y compilación de server.py.

• Reglas de seguridad del Circuit Breaker y mitigación de inyecciones.

• Decodificación robusta de salidas UTF-16LE / ANSI CP1252 de accoreconsole.

• Cubicaciones métricas, áreas poligonales (Fórmula de Shoelace con arcos) y exportación UTF-8-BOM.

• Auditoría topológica y limpieza de micro-geometría.

📄 Licencia

Este proyecto está distribuido bajo los términos de la Licencia MIT. Consulta el archivo LICENSE para más detalles.