CE3X-MCP-Server
by jmcaamanog
README.md
# 🏢 CE3X-MCP-Server (Certificación Energética con IA & FastMCP)
| 🏗️ Perfil & ConTech | 📈 Repositorio & Enlaces |
| :--- | :--- |
|  <br>  <br>  <br>  <br>  <br>  <br>  <br>  | [](https://pypi.org/project/ce3x-mcp-server/) <br> [](https://pypi.org/project/ce3x-mcp-server/) <br> [](https://github.com/jmcaamanog/CE3X-MCP-Server/releases/latest) <br> [](https://github.com/jmcaamanog/CE3X-MCP-Server/stargazers) <br> [](./LICENSE) <br> [](https://www.linkedin.com/in/jmcaamanog/) <br> [](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. |
| **Instalador 1-Clic** | 🖱️ **[Ver Instalador Windows](./instalar_en_claude_desktop.bat)** | Script autoejecutable para configurar Claude Desktop y Cursor. |
| **Skills para Claude/GPT/Gemini** | 🧠 **[Ver Guía de Skills](./docs/GUIA_SKILL_CLAUDE_GPT_GEMINI.md)** | Manual operativo para que cualquier IA razone como un Arquitecto Técnico. |
| **Paquete PyPI Oficial** | 📦 **[Ver en PyPI](https://pypi.org/project/ce3x-mcp-server/)** | Distribución oficial en el Python Package Index (`pip install ce3x-mcp-server`). |
| **Notas de Release v1.0** | 📜 **[Ver Release Notes v1.0](./docs/RELEASE_NOTES_v1.0.md)** | Manifiesto de capacidades, paquetes wheel y distribución oficial. |
| **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 **25 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 el paquete oficial de PyPI:
```json
{
"mcpServers": {
"ce3x": {
"command": "uvx",
"args": [
"--from",
"ce3x-mcp-server",
"ce3x-mcp"
]
}
}
}
```
### 2. Cursor IDE (`.cursor/mcp.json` o Settings > MCP)
En Cursor, ve a **Settings > MCP Servers** (o añade en tu archivo `.cursor/mcp.json`):
```json
{
"mcpServers": {
"ce3x": {
"command": "uvx",
"args": [
"--from",
"ce3x-mcp-server",
"ce3x-mcp"
]
}
}
}
```
### 3. Antigravity IDE / Gemini (`~/.gemini/config/mcp_config.json`)
```json
{
"mcpServers": {
"ce3x": {
"command": "uvx",
"args": [
"--from",
"ce3x-mcp-server",
"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 25 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.
12. `registrar_ensayo_flujometria_termica_in_situ(flujo, temp_int, temp_ext, duracion)`: Ensayo in situ de flujometría térmica (UNE-EN ISO 9869-1) para determinar la transmitancia U real de muros.
### 💡 Rehabilitación y Subvenciones Públicas
13. `proponer_medidas_mejora_rd390(...)`: Generación de paquetes de envolvente, equipos e hibridación con fotovoltaica.
14. `emitir_dictamen_subvenciones_nextgen(...)`: Dictamen técnico oficial con tramos del 40%, 65%, 80% (RD 853/2021) e IRPF.
### 📐 Envolvente, Sombras y Terciario
15. `calcular_sombras_hueco(orientacion, ancho, alto, retranqueo, voladizo, toldo)`: Factor solar estacional F_sh para huecos según CTE DB-HE.
16. `calcular_sombras_obstaculo_edificio_enfrente(distancia, altura, orientacion)`: Ángulo alfa y factor de sombra por edificio enfrente / obstáculo remoto.
17. `calcular_parametros_terciario_local_comercial(tipo, m2, luminarias)`: Potencia de iluminación W/m², VEEI según DB-HE 3 y caudal RITE.
18. `configurar_perfil_tecnico_colegiado(nombre, nif, titulacion, colegio)`: Registro persistente de la firma y credenciales del técnico.
### 📐 Cálculos Normativos Especializados (ISO & CTE)
24. `calcular_transmitancia_ventana_iso10077(ancho, alto, u_vidrio, u_marco, fraccion_marco, intercalario)`: Cálculo riguroso de transmitancia térmica total $U_w$ según la norma UNE-EN ISO 10077-1 (vidrio $U_g$, marco $U_f$, fracción de hueco y puente térmico perimetral $\Psi_g$).
25. `calcular_demanda_acs_cte_he4(numero_dormitorios, provincia, ocupantes, litros_persona_dia)`: Demanda reglamentaria obligatoria de ACS a 60 °C ($l/día$ y $kWh/año$) según dotaciones del CTE DB-HE 4 y tabla mensual de temperatura de red provincial.
### 📂 Gestión Integral de Carpeta de Visita y Entregables
19. `organizar_carpeta_visita(ruta_carpeta)`: Auto-organizador inteligente en 5 carpetas (INFORMACION, PLANOS, FOTOS, INSTALACIONES, CERTIFICADO).
20. `auditar_carpeta_visita(ruta_carpeta)`: Escaneo autónomo multimodal de la visita y generación de preguntas quirúrgicas.
21. `certificar_desde_carpeta_visita(ruta_carpeta, ...)`: Ciclo completo que genera todos los entregables en `CERTIFICADO/`.
22. `calcular_calificacion_energetica(proyecto)`: Motor de cálculo simplificado de demandas, consumos y emisiones.
23. `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)
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo issues