weishaupt-wem-mcp-server
Weishaupt WEM Portal MCP Server
Controla y supervisa tu sistema de calefacción Weishaupt con asistentes de IA a través del WEM Portal
Características
Descubrimiento de dispositivos - Lista todos los dispositivos y módulos de tu cuenta de WEM Portal
Parámetros en vivo - Lee temperaturas, presión y modos de funcionamiento con sus valores actuales
Vista general completa - Obtén una instantánea completa de todo tu sistema de calefacción en una sola llamada
Escritura de parámetros - Ajusta temperaturas objetivo, modos de funcionamiento y programaciones
Estado del dispositivo - Comprueba el estado de conexión de tus dispositivos
Filtro de parámetros modificables - Lista solo los parámetros que realmente puedes cambiar
Gestión de sesiones - Autenticación automática basada en cookies con bloqueo de inicio de sesión para solicitudes concurrentes
Related MCP server: victron-tcp
Inicio rápido
Instalación mediante npx (recomendado)
No es necesaria ninguna instalación. Configura tu cliente MCP para ejecutar:
npx @disane-dev/weishaupt-wem-mcp-serverInstalación desde el código fuente
git clone https://github.com/Disane87/weishaupt-wem-mcp-server.git
cd weishaupt-wem-mcp-server
npm install
npm run buildConfiguración
Añade lo siguiente a la configuración de Claude Desktop:
Windows:
%APPDATA%\Claude\claude_desktop_config.jsonmacOS:
~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"weishaupt-wem": {
"command": "npx",
"args": ["-y", "@disane-dev/weishaupt-wem-mcp-server"],
"env": {
"WEM_USERNAME": "your_email@example.com",
"WEM_PASSWORD": "your_password"
}
}
}
}claude mcp add weishaupt-wem -- npx -y @disane-dev/weishaupt-wem-mcp-serverEstablece las variables de entorno WEM_USERNAME y WEM_PASSWORD antes de empezar.
{
"mcpServers": {
"weishaupt-wem": {
"command": "node",
"args": ["/path/to/wem-mcp/build/index.js"],
"env": {
"WEM_USERNAME": "your_email@example.com",
"WEM_PASSWORD": "your_password"
}
}
}
}Variables de entorno
Variable | Requerida | Descripción |
| Sí | Tu correo electrónico de WEM Portal |
| Sí | Tu contraseña de WEM Portal |
| No | URL base de la API (por defecto: |
Herramientas disponibles
Tool | Descripción |
| Lista todos los dispositivos con sus módulos. Llama a esta primero para descubrir los IDs. |
| Obtiene el estado de conexión de un dispositivo |
| Vista general completa del dispositivo: todos los módulos con todos los parámetros en una sola llamada |
| Obtiene todos los parámetros de un módulo con sus valores actuales |
| Obtiene los metadatos de los parámetros (nombres, mín/máx, enumeraciones, indicador de escritura) |
| Lista solo los parámetros ajustables con rangos y opciones |
| Lee valores de parámetros específicos por ID |
| Establece un valor de parámetro (p. ej., temperatura objetivo) |
[!TIP] Empieza con
wem_get_devicespara descubrir tudeviceId,moduleIndexymoduleType; después usawem_get_overviewpara obtener una instantánea completa de tu sistema de calefacción.
Flujo de trabajo típico
1. wem_get_devices
-> Returns devices with modules (WE0=heat generator, HZK0=heating circuit, WW0=hot water)
2. wem_get_overview (deviceId)
-> Returns ALL modules with ALL parameters in one call
3. wem_get_writable_parameters (deviceId, moduleIndex, moduleType)
-> Shows what you can adjust, with min/max ranges
4. wem_write_parameter (deviceId, moduleIndex, moduleType, parameterId, numericValue)
-> Sets a writable parameter (e.g. target temperature)Tipos de módulo comunes
Tipo | Nombre | Descripción |
1 | SYSTEM | Resumen del sistema |
2 | HZK | Circuito de calefacción (temperaturas, modo de funcionamiento) |
3 | WW | Agua caliente (temperatura, impulso, programación) |
5 | TERMINAL | Panel de control |
6 | GATEWAY | Pasarela de comunicación |
7 | WE | Generador de calor (rendimiento de caldera/bomba de calor) |
9 | Device | Unidad física del dispositivo |
10 | GROUND | Módulo de tierra |
Desarrollo
Comando | Descripción |
| Compila el proyecto |
| Modo de vigilancia (recompilación automática ante cambios) |
| Ejecuta el servidor directamente |
| Prueba la conexión con la API |
| Inspector oficial de MCP (interfaz web) |
| Inspector CLI para pruebas rápidas de la API |
Solución de problemas
[!NOTE] Asegúrate de que puedes iniciar sesión en wemportal.com antes de usar este servidor.
Problema | Solución |
Error de autenticación | Verifica las credenciales; comprueba si WEM Portal bloquea tras demasiados intentos |
Tiempo de espera agotado | Comprueba la conexión a internet; WEM Portal puede no estar disponible temporalmente (tiempo de espera predeterminado de 30 s) |
Los valores de los parámetros muestran 0 | Algunos parámetros (p. ej., temperatura ambiente) requieren un sensor físico conectado al dispositivo |
Contribuciones
¡Las contribuciones son bienvenidas! Abre un issue o envía una pull request.
Licencia
MIT - consulta LICENSE
disane.dev | Blog | GitHub | npm
This server cannot be deployed
Maintenance
Related MCP Connectors
Home energy for AI assistants: live Power flow, Energy history, solar forecast, and device control.
1- mytesla.ioOAuthio.mytesla
Control your Tesla from your AI assistant - climate, charging, access, and security.
weclapp ERP in your AI assistant: reads instantly, writes only after a preview you approve.
Heating, ventilation and energy engineering calculations and diagnostics for AI agents.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with Home Assistant smart home devices through natural language. Control devices, manage automations, query entity states, and retrieve historical data across your home automation system.1MIT
- AlicenseAqualityAmaintenanceConnect AI assistants to Victron Energy systems to read real-time solar, battery, grid, and inverter data from your local network via Modbus TCP or MQTT.3295 npm4MIT
- AlicenseNot gradedqualityCmaintenanceEnables LLM applications to query and visualize data from Bosch/Buderus heat pumps via ems-ESP, including temperatures, statistics, and heat curves through natural language.9MIT
- AlicenseAqualityDmaintenanceAn unofficial MCP (Model Context Protocol) server that exposes a Vaillant heat pump's data to AI assistants like Claude. Query outdoor and room temperatures, hot water status, energy consumption, COP estimates, schedules, and diagnostics through natural conversation.4MIT