Skip to main content
Glama
BricsCAD-MCP

BricsCAD-MCP

by samuelsl27

BricsCAD-MCP

Servidor MCP (Model Context Protocol) para controlar BricsCAD V25/V26 en lenguaje natural desde Claude Desktop.

No existe un MCP oficial de Bricsys/Octave (confirmado en el foro oficial en 2025: «There is no such a feature yet»). Este proyecto parte del mejor servidor libre disponible —multiCAD-mcp, Apache-2.0— y lo especializa en BricsCAD, añadiendo lo que a aquél le faltaba: ejecución de LISP arbitrario con retorno de valor.


Qué aporta frente al proyecto original

multiCAD-mcp

BricsCAD-MCP

CAD soportados

4 (genérico)

BricsCAD V23–V26, especializado

Detección de ProgID

uno fijo

lista de candidatos versionados con sondeo

LISP arbitrario

✗

✓ puente de ficheros con retorno de valor y captura de errores

Comandos nativos

solo internos

✓ send_command y scripts .scr

Variables de sistema

✗

✓ GETVAR / SETVAR por COM

Volcado DXF (entget)

✗

✓ por handle

Deshacer agrupado

✗

✓ cada operación LISP en un único grupo de UNDO

Diagnóstico de instalación

✗

✓ scripts/detect_bricscad.py

Selección actual del usuario

✗

✓ «a lo seleccionado…», sin destruir la selección

Inspección previa / resaltado

✗

✓ describe y highlight antes de modificar

Textos de DXF de QGIS

✗

✓ text_height quita el \H incrustado

Idioma

inglés

castellano


Related MCP server: multiCAD-mcp

Arquitectura

Claude Desktop
      │  stdio (MCP)
      ▼
  src/server.py  ──────────────  FastMCP: 8 herramientas unificadas
      │
      ▼
  BricsCADAdapter  (mixins: dibujo, capas, bloques, entidades, export, LISP…)
      │
      ├─── COM  (BricscadApp.AcadApplication.25)  ──► BricsCAD V25
      │
      └─── Puente LISP  (ficheros .lsp / .res)   ──► intérprete LISP de BricsCAD

El puente LISP evita todos los problemas de escapado: el servidor escribe el código en un .lsp temporal, envía (mcp:run-file "código.lsp" "resultado.res") por SendCommand, y el puente lisp/mcp_bridge.lsp devuelve el valor —o el mensaje de error— en el fichero de respuesta, que el servidor lee y convierte a JSON. A diferencia de AutoCAD LT (que necesita trucos con PostMessageW), BricsCAD completo expone SendCommand por COM y soporta LISP de forma nativa.


Herramientas MCP

Herramienta

Qué hace

manage_session

Conectar/desconectar, estado, zoom extensión, captura, deshacer/rehacer, panel web

draw_entities

Líneas, círculos, arcos, rectángulos, polilíneas, elipses, splines, textos, sombreados, cotas, directrices, tablas, matrices

manage_layers

Crear, listar, renombrar, borrar, encender/apagar, color, capa actual

manage_files

Nuevo, abrir, guardar (DWG/DXF/PDF), cerrar, cambiar entre dibujos

manage_entities

Selección actual del usuario, inspección, resaltado, altura de texto (con limpieza de DXF de QGIS); mover, girar, escalar, copiar, borrar, propiedades; selección por tipo/capa/color

manage_blocks

Crear, insertar (individual y por lotes), listar, atributos

export_data

Extracción a JSON y Excel, depuración de entidades

execute_lisp

LISP arbitrario, comandos nativos, scripts .scr, GETVAR/SETVAR, entget, purgar y auditar

Detalle completo en docs/03-HERRAMIENTAS.md.


Instalación

Requisitos: Windows 10/11, BricsCAD V23 o superior (probado en V25) y Python 3.10–3.14 (si solo hay uno más nuevo, el instalador consigue un 3.13 con uv).

Copia el repositorio a un disco local (sin la carpeta .venv) y haz doble clic en INSTALAR.bat, o:

cd C:\IMGA\MCP_Briccad
py install.py

El instalador elige un Python compatible, crea el entorno virtual (lo recrea si viene copiado de otro equipo), instala las dependencias, arranca el servidor de prueba, ejecuta el diagnóstico de BricsCAD y lo registra en claude_desktop_config.json (ruta clásica o MSIX, con copia de seguridad y conservando los servidores existentes).

Después: abre BricsCAD, reinicia Claude Desktop del todo y prueba con «conecta con BricsCAD y dime en qué dibujo estoy».

Pasos manuales y solución de problemas en docs/01-INSTALACION.md y docs/05-PROBLEMAS.md. Auditoría de seguridad previa en docs/06-SEGURIDAD.md.


Diagnóstico rápido

.\.venv\Scripts\python.exe scripts\detect_bricscad.py

Muestra los ProgID registrados, las versiones instaladas y si hay una instancia de BricsCAD accesible por COM.


Ejemplos de uso

«Crea la capa TALUDES en color rojo y dibuja en ella la polilínea que une 0,0 – 50,0 – 50,30 – 0,30 cerrada.»

«Cuenta cuántas polilíneas hay en la capa BERMAS y dame la longitud total.» → resuelto con execute_lisp:

(setq ss (ssget "_X" '((0 . "LWPOLYLINE") (8 . "BERMAS"))))
(setq tot 0.0 i 0)
(if ss (repeat (sslength ss)
  (setq e (vlax-ename->vla-object (ssname ss i)))
  (setq tot (+ tot (vlax-curve-getDistAtParam e (vlax-curve-getEndParam e))))
  (setq i (1+ i))))
(list (if ss (sslength ss) 0) tot)

«Purga y audita el dibujo, luego guárdalo como DWG en la carpeta del proyecto.»

«A los textos que tengo seleccionados ponles altura 2,5.» → current (37 MTEXT en la capa DPH_parcela, altura 0,66) → confirma → text_height|selection|2.5: quita el \H0.66053; que trae el DXF de QGIS y fija la altura, todo en un solo UNDO.


Seguridad

execute_lisp ejecuta código arbitrario dentro de BricsCAD, con los permisos del usuario. Trátalo como lo que es: una consola de programación.

  • El puente envuelve cada ejecución en un grupo de DESHACER, de modo que un único UNDO revierte la operación completa.

  • Los errores de LISP se capturan con vl-catch-all-apply: BricsCAD nunca queda bloqueado en el diálogo de error.

  • BricsCAD puede exigir que la carpeta del puente esté en las rutas de confianza (TRUSTEDPATHS); el instalador lo indica si hace falta.

  • El servidor solo habla por stdio con Claude Desktop y no abre ninguna conexión de red: el panel web viene desactivado y no se hace ni una petición fuera de 127.0.0.1.

  • Por defecto no mueve el ratón ni escribe fuera de la carpeta de exportación.

El árbol completo se auditó antes de la primera ejecución —sin eval, sin subprocesos, sin red saliente, sin ofuscación— y se endurecieron cuatro valores por defecto. El detalle, en docs/06-SEGURIDAD.md.


Desarrollo

Este proyecto se desarrolla con Spec-Driven Development: primero la especificación, después el código, y el código se valida contra ella.

Documento

Qué contiene

DESARROLLO.md

Bitácora: cómo se construyó, los diez problemas que aparecieron y cómo se resolvieron, y un prompt reutilizable para instalarlo en otro equipo

AGENTS.md

Contexto para agentes de IA: mapa del repositorio y reglas que no se negocian

docs/constitution.md

Los ocho principios del proyecto

docs/sdd/README.md

La metodología, la notación EARS y el ciclo de trabajo

docs/sdd/PROMPTS.md

Prompts listos para cada fase

specs/

Una carpeta por funcionalidad: spec.md, plan.md, tasks.md

Especificaciones actuales:

Flujo de ramas y convención de commits en docs/04-DESARROLLO.md.


Licencia y atribución

Apache-2.0. Obra derivada de AnCode666/multiCAD-mcp (Apache-2.0); consulta NOTICE para el detalle de la atribución y los cambios.

Desarrollado por IMGA, S.L.P. — Ingeniería Minera, Geológica y Ambiental.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI clients like Claude Desktop to control AutoCAD through natural language commands using the Model Context Protocol.
      9
      MIT
    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants like Claude for Desktop or Cursor to control supported CAD applications through natural language, including drawing, layer/entity/block management, data export, and file/session operations.
      -
    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants such as Claude for Desktop or Cursor to control CAD applications including AutoCAD, ZWCAD, GstarCAD, and BricsCAD through the Model Context Protocol, using natural-language or direct tool calls for drawing, layers, blocks, entities, files, and data export.
      -
    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants like Claude for Desktop or Cursor to control AutoCAD, ZWCAD, GstarCAD, and BricsCAD for drawing, layer, block, entity, export, and file operations through natural language or direct tool calls.
      -