Metadata-Version: 2.4
Name: ce3x-mcp-server
Version: 1.3.0
Summary: Servidor MCP Oficial para Certificación de Eficiencia Energética de Edificios (CE3X / CTE DB-HE / RD 390/2021)
Author-email: Jose Manuel Caamaño González <jmc@example.com>
License: MIT
Keywords: mcp,model-context-protocol,ce3x,eficiencia-energetica,cte-db-he,contech,bim,certificacion-energetica,typst
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: Topic :: Scientific/Engineering
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: fastmcp>=0.4.0
Requires-Dist: pydantic>=2.6.0
Requires-Dist: lxml>=5.1.0
Requires-Dist: requests>=2.31.0
Requires-Dist: pymupdf>=1.24.0
Requires-Dist: shapely>=2.0.0
Requires-Dist: rich>=13.7.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0.0; extra == "dev"
Requires-Dist: black>=24.0.0; extra == "dev"
Requires-Dist: ruff>=0.3.0; extra == "dev"
Provides-Extra: bim
Requires-Dist: ifcopenshell>=0.7.0; extra == "bim"
Dynamic: license-file

# 🏢 CE3X-MCP-Server (Certificación Energética con IA & FastMCP)

| 🏗️ Perfil & ConTech | 📈 Repositorio & Enlaces |
| :--- | :--- |
| ![Profesión](https://img.shields.io/badge/Profesi%C3%B3n-Arquitectos%20T%C3%A9cnicos-2e7d32?logo=micro%3Abit&logoColor=white&style=plastic) <br> ![Role](https://img.shields.io/badge/Role-BIM%20%26%20ConTech-007ACC?logo=bim360&style=plastic) <br> ![Location](https://img.shields.io/badge/Location-A%20Coru%C3%B1a%20%F0%9F%8C%8A-005B94?logo=lighthouse&logoColor=white&style=plastic) <br> ![Sector](https://img.shields.io/badge/Sector-ConTech%20%7C%20AECO-E65100?logo=construct3&style=plastic) <br> ![Protocol](https://img.shields.io/badge/Protocol-Model%20Context%20Protocol-8A2BE2?logo=anthropic&style=plastic) <br> ![Engine](https://img.shields.io/badge/Engine-FastMCP%20%26%20Typst-10b981?logo=python&style=plastic) <br> ![Normativa](https://img.shields.io/badge/Normativa-CTE%20DB--HE%20%7C%20RD%20390%2F2021-d97706?style=plastic) <br> ![Language](https://img.shields.io/badge/Language-Python%203.11-3776AB?logo=python&logoColor=white&style=plastic) | [![Versión](https://img.shields.io/github/v/release/jmcaamanog/CE3X-MCP-Server?label=Version&color=3b82f6&logo=github&style=plastic)](https://github.com/jmcaamanog/CE3X-MCP-Server/releases/latest) <br> [![Stars](https://img.shields.io/github/stars/jmcaamanog/CE3X-MCP-Server?style=plastic&label=Stars&color=f59e0b&logo=github)](https://github.com/jmcaamanog/CE3X-MCP-Server/stargazers) <br> [![Licencia](https://img.shields.io/badge/Licencia-MIT-8b5cf6.svg?style=plastic)](./LICENSE) <br> [![LinkedIn](https://img.shields.io/badge/LinkedIn-0077B5?style=plastic&logo=linkedin)](https://www.linkedin.com/in/jmcaamanog/) <br> [![Web](https://img.shields.io/badge/Web-jmcaamanog.pages.dev-005B94?style=plastic)](https://jmcaamanog.pages.dev) |

### Servidor MCP Oficial para Automatizar Certificados de Eficiencia Energética con IA (Claude, Gemini, Cursor)
*Diseñado bajo la perspectiva técnica de un Arquitecto Técnico & BIM Manager para dotar al sector AECO de una herramienta libre, rigurosa y ultrarrápida.*

---

## ⚡ Enlaces y Accesos Rápidos

| 🌟 Recurso | 🚀 Acción / Enlace | 📝 Descripción |
| :--- | :--- | :--- |
| **Estructura de Visita** | 📁 **[Ver Guía 5 Carpetas](./docs/ESTRUCTURA_CARPETA_VISITA.md)** | Arquitectura canónica para organizar fotos, planos, notas y certificados. |
| **Estudio de Conectores** | 🌐 **[Ver Estudio Integral de Conexiones](./docs/ESTUDIO_INTEGRAL_CONECTORES_CE3X_MCP.md)** | Mapeo pantalla a pantalla, botón a botón y ensayos de CE3X a conectores de IA. |
| **Documento de Análisis** | 📄 **[Ver Análisis CE3X & MCP](./docs/analisis_ce3x_mcp_framework.md)** | Análisis exhaustivo del software, manuales técnicos y arquitectura modular. |
| **Plantilla de Campo** | 📋 **[Ver Plantilla de Toma de Datos](./docs/PLANTILLA_TOMA_DATOS_CEE.md)** | Formulario estructurado para visitas de campo y dictado por voz. |
| **Guía para tu IA** | 🧠 **[Ver Instrucciones para la IA](./docs/GUIA_PROMPTS_Y_INSTRUCCIONES_IA.md)** | System prompts y protocolo de primer contacto para Claude, Gemini y Cursor. |
| **Historial de Versiones** | 📜 **[Ver Changelog](./CHANGELOG.md)** | Registro detallado de versiones y mejoras implementadas. |
| **Código de Conducta** | 🤝 **[Ver Código de Conducta](./CODE_OF_CONDUCT.md)** | El manual del buen rollo y convivencia comunitaria. |
| **Guía de Contribución** | 🛠️ **[Ver Cómo Contribuir](./CONTRIBUTING.md)** | Pautas para reportar bugs, proponer ideas y enviar Pull Requests. |
| **Seguridad** | 🛡️ **[Ver Política de Seguridad](./SECURITY.md)** | Divulgación responsable y reporte de vulnerabilidades. |
| **Repositorio GitHub** | 💻 **[GitHub jmcaamanog](https://github.com/jmcaamanog/CE3X-MCP-Server)** | Código fuente, issues y lanzamientos oficiales. |

---

## 👥 Perfiles y Modos de Uso para Cualquier Profesional

| Perfil / Modo | Icono | Descripción del Flujo | Entrada Requerida | Entregables Generados |
| :--- | :---: | :--- | :--- | :--- |
| **Modo Express (Datos Mínimos)** | ⚡ | **Certificación ultrarrápida en segundos** interactuando por chat. La IA infiere automáticamente la envolvente y el clima normativo oficial. | Referencia Catastral (o municipio) + año + superficie + climatización básica. | Archivo `.cex`, XML oficial v3.0 homologado y **PDF oficial de 15 páginas**. |
| **Modo Técnico Documental** | 📐 | **Extracción multimodal asistida por IA**. Lee planos arquitectónicos en PDF y fotos de placas de características de equipos térmicos. | Plano de distribución en PDF/imagen + fotos o fichas técnicas de caldera/aerotermia. | Desglose completo de estancias, fachadas, ventanas, potencias y rendimientos estacionales (SCOP/COP). |
| **Modo BIM & Auditoría NextGen** | 🏗️ | **Conexión directa con modelos BIM** y justificación automática de subvenciones públicas y deducciones IRPF. | Archivo BIM `.ifc` (Revit, Archicad, CYPE) o proyecto de rehabilitación. | Cubicación BIM con `IfcOpenShell`, cálculo solar satelital PVGIS, salto a letra A y **Dictamen NextGen (RD 853/2021)**. |

---

## 🚀 Guía Rápida para Usuarios Noveles (Empieza en 3 Pasos)

> [!IMPORTANT] 📥
> ### 🎯 ¿No quieres lidiar con consolas, comandos ni archivos JSON?
> Sigue estos 3 pasos inmediatos para tener la herramienta funcionando en 1 minuto:
> 
> 1. **Doble Clic al Instalador:** Haz doble clic sobre [`instalar_en_claude_desktop.bat`](./instalar_en_claude_desktop.bat) en la raíz del repositorio. Configurará Claude Desktop y Cursor automáticamente sin tocar nada de código.
> 2. **Abre Claude Desktop o Cursor:** El servidor `ce3x` aparecerá conectado y listo para usar con sus **22 herramientas oficiales**.
> 3. **Escribe en el chat:**  
>    > *"Certifica la vivienda de la carpeta `ejemplos/visita_vivienda_ejemplo`"*  
>    *(Verás cómo la IA organiza las fotos, planos y notas, y genera la carpeta `CERTIFICADO/` con los archivos oficiales).*
>
> ---
>
> 📦 **¿Prefieres usar PyPI / `uvx` directamente sin clonar nada?**  
> Copia estas 4 líneas en tu archivo de configuración de Claude Desktop o Cursor:
> ```json
> "ce3x": {
>   "command": "uvx",
>   "args": ["ce3x-mcp"]
> }
> ```

---

## 🔌 Configuración Inmediata en Clientes de IA

### 1. Claude Desktop (`claude_desktop_config.json`)
Abre tu configuración de Claude Desktop (%APPDATA%\Claude\claude_desktop_config.json en Windows o ~/Library/Application Support/Claude/claude_desktop_config.json en macOS) y añade:

```json
{
  "mcpServers": {
    "ce3x": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/jmcaamanog/CE3X-MCP-Server.git",
        "ce3x-mcp"
      ]
    }
  }
}
```

### 2. Cursor IDE (`.cursor/mcp.json` o Settings > MCP)
En Cursor, ve a **Features > MCP Servers** o añade en tu archivo `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "ce3x": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/jmcaamanog/CE3X-MCP-Server.git",
        "ce3x-mcp"
      ]
    }
  }
}
```

### 3. Antigravity IDE / Gemini (`~/.gemini/config/mcp_config.json`)
```json
{
  "mcpServers": {
    "ce3x": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/jmcaamanog/CE3X-MCP-Server.git",
        "ce3x-mcp"
      ]
    }
  }
}
```

### 4. Instalación Local para Desarrollo (Opcional con `pip`)
Si prefieres tener el repositorio clonado y trabajar en local:

```bash
git clone https://github.com/jmcaamanog/CE3X-MCP-Server.git
cd CE3X-MCP-Server
python -m venv .venv
.venv\Scripts\activate
pip install -e .
```

Y en tu archivo de configuración MCP indicas el intérprete local:

```json
{
  "mcpServers": {
    "ce3x": {
      "command": "C:\\ruta\\al\\repositorio\\.venv\\Scripts\\python.exe",
      "args": [
        "-I",
        "-m",
        "ce3x_mcp.server"
      ],
      "env": {
        "PYTHONPATH": "C:\\ruta\\al\\repositorio\\src"
      }
    }
  }
}
```

---

## 🌟 Características Principales (ConTech & AI Cert)

| Módulo | Icono | Funcionalidades Destacadas |
| :--- | :---: | :--- |
| **Ingesta Catastral Automática** | 🏛️ | Conexión directa con la **Sede Electrónica del Catastro (OVC)** para extraer datos oficiales, año de edificación, superficie y dirección con solo la Referencia Catastral. |
| **Motor Normativo CTE DB-HE** | 📐 | Determinación automática de **zonas climáticas CTE (α1 a E1)** con corrección por altitud y asignación de transmitancias límite e históricas (NBE-CT-79, CTE 2006/2013/2019). |
| **Exportación a CE3X (.cex)** | 💾 | Generación y lectura nativa de archivos de proyecto **.cex** para abrir, auditar y recalcular en la interfaz oficial de CE3X v3.2. |
| **XML Oficial de Registro** | 📑 | Creación de archivos XML normalizados conforme a la especificación **DatosEnergeticosDelEdificio v3.0**, validados al 100% contra el esquema RelaxNG oficial del Ministerio. |
| **Compilación de PDF Homologado** | 🖨️ | Integración con **Typst / xml2cert** (IETcc-CSIC) para compilar en segundos el certificado oficial completo de 15 páginas con gráficos y anejos. |
| **Cálculo Solar Satelital PVGIS** | ☀️ | Conexión en vivo con la **API oficial PVGIS de la Comisión Europea** (JRC) para estimar la producción fotovoltaica real (kWh/año) según radiación satelital SARAH-2. |
| **Medidas de Mejora & NextGen** | 🌿 | Propuesta automatizada de paquetes de rehabilitación (SATE, aerotermia, fotovoltaica) con cálculo de ahorro %, nuevo salto de letra, amortización y **dictamen para ayudas RD 853/2021 y deducciones IRPF**. |

---

## 🛠️ Catálogo Completo de 22 Herramientas MCP Disponibles

El servidor implementa el mapeo total y exhaustivo de CE3X v3.2, manuales técnicos y normativas oficiales:

### 🏛️ Datos Administrativos, Catastro y Clima
1. `consultar_catastro(referencia_catastral)`: Ingesta telemática en tiempo real desde la Sede Electrónica de Catastro.
2. `determinar_zona_climatica(provincia, municipio, altitud)`: Clima oficial de referencia CTE DB-HE con corrección por cota.
3. `registrar_visita_presencial(fecha_visita, pruebas, observaciones)`: Registro formal in situ para el Anexo IV obligatorio (RD 390/2021 Art. 8).

### 📐 Envolvente Térmica, BIM y Planos
4. `estimar_envolvente_por_defecto(ano_construccion, zona, superficie)`: Transmitancias U históricas (Pre-79, NBE-CT-79, CTE).
5. `analizar_modelo_bim_ifc(ifc_path)`: Cubicación paramétrica de muros, cubiertas y huecos desde modelos IFC (IfcOpenShell).
6. `analizar_plano_arquitectura_pdf(pdf_path)`: Extracción inteligente de superficies y carpinterías desde planos en PDF.
7. `calcular_puentes_termicos(ano, perimetro_forjado, perimetro_huecos, pilares)`: Transmitancias lineales psi (W/m·K) según DA DB-HE / 3.

### ⚙️ Instalaciones, Equipos y Renovables
8. `analizar_ficha_equipo_clima(texto_o_ficha)`: Lectura de bombas de calor, calderas, potencias y SCOP/COP.
9. `calcular_produccion_fotovoltaica_pvgis(lat, lon, kwp)`: Simulación satelital en tiempo real con datos de la Comisión Europea.

### 🧪 Ensayos Oficiales y Contraste de Consumos
10. `registrar_ensayo_estanqueidad_blower_door(volumen, superficie, caudal_50pa)`: Ensayo Blower Door (UNE-EN ISO 9972) con cálculo de n50 y q50.
11. `contrastar_consumo_facturas_reales(consumo_teorico, electricidad, gas, gasoleo)`: Contraste de facturación real vs modelo normativo.

### 💡 Rehabilitación y Subvenciones Públicas
12. `proponer_medidas_mejora_rd390(...)`: Generación de paquetes de envolvente, equipos e hibridación con fotovoltaica.
13. `emitir_dictamen_subvenciones_nextgen(...)`: Dictamen técnico oficial con tramos del 40%, 65%, 80% (RD 853/2021) e IRPF.

### 📐 Envolvente, Sombras y Terciario
14. `calcular_sombras_hueco(orientacion, ancho, alto, retranqueo, voladizo, toldo)`: Factor solar estacional F_sh para huecos según CTE DB-HE.
15. `calcular_sombras_obstaculo_edificio_enfrente(distancia, altura, orientacion)`: Ángulo alfa y factor de sombra por edificio enfrente / obstáculo remoto.
16. `calcular_parametros_terciario_local_comercial(tipo, m2, luminarias)`: Potencia de iluminación W/m², VEEI según DB-HE 3 y caudal RITE.
17. `configurar_perfil_tecnico_colegiado(nombre, nif, titulacion, colegio)`: Registro persistente de la firma y credenciales del técnico.

### 📂 Gestión Integral de Carpeta de Visita y Entregables
18. `organizar_carpeta_visita(ruta_carpeta)`: Auto-organizador inteligente en 5 carpetas (INFORMACION, PLANOS, FOTOS, INSTALACIONES, CERTIFICADO).
19. `auditar_carpeta_visita(ruta_carpeta)`: Escaneo autónomo multimodal de la visita y generación de preguntas quirúrgicas.
20. `certificar_desde_carpeta_visita(ruta_carpeta, ...)`: Ciclo completo que genera todos los entregables en `CERTIFICADO/`.
21. `calcular_calificacion_energetica(proyecto)`: Motor de cálculo simplificado de demandas, consumos y emisiones.
22. `generar_certificado_completo(...)`: Pipeline integral que emite el `.cex` nativo, XML oficial v3.0 y PDF de 15 páginas.

---



## 👨‍💻 Autor y Dirección Técnica

**Jose Manuel Caamaño González** | Arquitecto Técnico & BIM Manager  
Digital Product Lead | ConTech & Digital Twin SaaS | Data Analytics (SQL, Power BI)  

Hecho con código y café desde A Coruña. ☕  
[LinkedIn](https://www.linkedin.com/in/jmcaamanog/) · [Web](https://jmcaamanog.pages.dev)
