Skip to main content
Glama
edu3250

unifilar-fv

by edu3250
README.md
# unifilar-fv

Integración de **Claude ↔ AutoCAD** mediante un servidor **MCP** (Model Context Protocol) para generar
**diagramas unifilares de sistemas fotovoltaicos** a partir de una especificación del sistema.

> Estado: fase inicial (investigación y arquitectura).

## Idea general

```
Claude (Claude Code / Claude Desktop)
        │  MCP (stdio)
        ▼
Servidor MCP unifilar-fv  ── herramientas de dominio: validar sistema FV, generar unifilar, exportar
        │
        ├── Backend ezdxf   → DXF/PNG sin AutoCAD (CI, previsualización)
        └── Backend COM     → AutoCAD 2027 en vivo (DWG, PDF)
```

Claude razona sobre el **sistema fotovoltaico** (módulos, strings, inversores, protecciones); el servidor
valida la especificación y dibuja el unifilar de forma determinista con símbolos IEC 60617.

## Requisitos

| Componente | Versión |
|---|---|
| Windows | 10/11 64-bit (para el backend AutoCAD) |
| AutoCAD | **2027 completo** (no LT; LT no tiene COM ni .NET) |
| Python | 3.11+ |

El backend headless (ezdxf) funciona en cualquier SO y no necesita AutoCAD.

## Desarrollo

```bash
python -m venv .venv
.venv\Scripts\activate            # Windows
pip install -e ".[dev]"
ruff check . && ruff format --check .
pytest
```

## Flujo de trabajo

Trabajamos con **GitHub Flow**: `main` siempre estable, una rama por cambio, Pull Request con CI en verde
y revisión antes de fusionar. Detalles en [`CONTRIBUTING.md`](CONTRIBUTING.md).