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

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

Related MCP server: idfkit-mcp

👥 Perfiles y Modos de Uso para Cualquier Profesional

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

"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:

{
  "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):

{
  "mcpServers": {
    "ce3x": {
      "command": "uvx",
      "args": [
        "--from",
        "ce3x-mcp-server",
        "ce3x-mcp"
      ]
    }
  }
}

3. Antigravity IDE / Gemini (~/.gemini/config/mcp_config.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:

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:

{
  "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)

🛠️ 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 · Web