autobat-v3

Servidor MCP de AutoCAD para Azcuy / BaterFlow. COM, no LISP. Sólo Windows.

Reemplaza a azcuy-autocad.

Requisitos

• Python >= 3.10, uv
• Windows con AutoCAD full abierto (LT no expone ActiveX/COM)
• pywin32

uv sync
uv run python server.py

Orden de trabajo

ping  ->  find_drawing / open_drawing  ->  read_drawing  ->  mapear  ->  escribir

read_drawing antes de escribir, siempre.

Tools

Archivos

tool	qué hace
find_drawing	busca DWG/DXF en disco por nombre
open_drawing	abre y activa (read_only=true por default)
list_open_drawings / set_active_drawing	qué hay abierto / cambiar de documento
create_working_copy	duplica en disco antes de tocar nada
create_drawing / save_drawing	crear / guardar

Lectura

tool	qué hace
read_drawing	panorama: unidades, extensión, conteos, XREF
list_layers	capas con color ACI (el grosor sale del color vía CTB)
list_blocks / inspect_block	tabla de bloques / radiografía de una definición
query_entities	consulta filtrada — filtra dentro de AutoCAD, es rápida
find_nested	entra en XREF y bloques, coordenadas de mundo compuestas
entities_near	interferencias por proximidad (ventana de cruce)
extract_attributes	atributos en formato tabla, para cómputo
locate_in_polygons	qué etiqueta cae en qué polígono (auditoría de superficies)

Dibujo

tool	qué hace
list_bathroom_types	las 70 tipologías de baño, con medidas. No toca AutoCAD
draw_bathroom	inserta la tipología real desde la biblioteca local
list_library / draw_from_library	todo lo dibujable: baños, artefactos, instalaciones
cut_corner	recorta un rectángulo de una esquina (columna que pasa)
list_references / draw_reference	símbolos convencionales (teclas, tomas, bocas)
draw_room	local paramétrico, polilínea cerrada + rótulo con superficie
import_block / insert_block / list_source_blocks	traer y colocar bloques reales
draw_line / draw_circle / draw_rectangle / draw_text	primitivas

Edición y escape

tool	qué hace
set_property	color, capa, tipo de línea… Para grosores en Azcuy: color
transform_entities / copy_entities / delete_entities	mover-rotar-escalar / copiar / borrar
undo	deshace el historial de AutoCAD
zoom_extents	vista
send_command	escotilla: comandos y AutoLISP. Filtrado, y asincrónico

Todo lo que modifica el dibujo devuelve un plan con affected_count y no toca nada hasta que se repite la llamada con confirm=true.

Decisiones que no son obvias

Las entidades hay que re-envolverlas en late binding. Iterar ModelSpace las devuelve tipadas como IAcadEntity: exponen Layer/Handle/EntityName pero no Center, Name ni Coordinates — y no fallan ruidosamente, tiran AttributeError que un getattr(..., None) convierte en dato vacío. Una lectura entera sale en cero sin un solo error. Ver com.LateEntity. No alcanza con evitar gencache: una vez generado el typelib, Dispatch común hace lo mismo.

El reintento es una primitiva, no un parche. AutoCAD rechaza llamadas mientras está ocupado (RPC_E_CALL_REJECTED). Sin reintentos son fallas intermitentes justo cuando el dibujo es grande.

Filtrar del lado de AutoCAD. Cada lectura de propiedad por COM cuesta ~1,6 ms fuera de proceso. Medido: recorrer en Python 20,7 s vs. 0,27 s con SelectionSet.

Los baños no se dibujan, se copian. Ver tools/draw_bathroom.py.

La biblioteca vive adentro del MCP. assets/library/ tiene un DWG chico por pieza (baños, artefactos, instalaciones), generado por build_library.py. Insertar es InsertBlock(punto, ruta.dwg, …): AutoCAD resuelve el archivo solo, sin abrir documentos, sin copiar y sin cerrar nada. Se regenera cuando Azcuy actualice sus archivos.

Las piezas vienen sin el rótulo del catálogo — y eso cambia las medidas. Cada tipología trae un MTEXT con la etiqueta (B2, A1) que no está encima del baño: está arriba y separado. Medir el bloque crudo suma el rótulo y el hueco. Medido: B02 es 2,9160 × 2,2125 m, no los 3,0986 × 4,5110 del bloque completo. Cualquier medida tomada sin sacar el rótulo está inflada.

Ninguna tool crea capas en silencio. Si el nombre no matchea, se detiene y avisa. create_layer=true es una decisión explícita.

Configuración

AUTOBAT_SEARCH_ROOTS — rutas separadas por ; donde se puede buscar y abrir. Es el sandbox: nada fuera de esas raíces se abre ni se guarda.

MCP

{
  "mcpServers": {
    "autobat-v3": {
      "command": "uv",
      "args": ["--directory", "C:/Users/Usuario/Documents/BaterFlow/autobat-v3",
               "run", "python", "server.py"]
    }
  }
}