ce3x-mcp-server 1.3.0__tar.gz

ce3x_mcp_server-1.3.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jose Manuel Caamaño González
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ce3x_mcp_server-1.3.0/PKG-INFO

@@ -0,0 +1,249 @@
+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)

ce3x_mcp_server-1.3.0/README.md

@@ -0,0 +1,215 @@
+# 🏢 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)

ce3x_mcp_server-1.3.0/pyproject.toml

@@ -0,0 +1,62 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ce3x-mcp-server"
+version = "1.3.0"
+description = "Servidor MCP Oficial para Certificación de Eficiencia Energética de Edificios (CE3X / CTE DB-HE / RD 390/2021)"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [
+    { name = "Jose Manuel Caamaño González", email = "jmc@example.com" }
+]
+keywords = [
+    "mcp",
+    "model-context-protocol",
+    "ce3x",
+    "eficiencia-energetica",
+    "cte-db-he",
+    "contech",
+    "bim",
+    "certificacion-energetica",
+    "typst"
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Intended Audience :: End Users/Desktop",
+    "Topic :: Scientific/Engineering",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+dependencies = [
+    "fastmcp>=0.4.0",
+    "pydantic>=2.6.0",
+    "lxml>=5.1.0",
+    "requests>=2.31.0",
+    "pymupdf>=1.24.0",
+    "shapely>=2.0.0",
+    "rich>=13.7.0"
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0.0",
+    "black>=24.0.0",
+    "ruff>=0.3.0"
+]
+bim = [
+    "ifcopenshell>=0.7.0"
+]
+
+[project.scripts]
+ce3x-mcp = "ce3x_mcp.server:main"
+ce3x-mcp-server = "ce3x_mcp.server:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]

ce3x_mcp_server-1.3.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

ce3x_mcp_server-1.3.0/src/ce3x_mcp/__init__.py

@@ -0,0 +1,9 @@
+"""
+CE3X-MCP-Server: Servidor MCP Oficial para Certificación Energética de Edificios.
+Automatización de certificados oficiales CE3X, CTE DB-HE y RD 390/2021.
+"""
+
+__version__ = "0.1.0"
+__author__ = "Jose Manuel Caamaño González"
+
+

ce3x_mcp_server-1.3.0/src/ce3x_mcp/core/__init__.py

@@ -0,0 +1,3 @@
+
+
+