weishaupt-wem-mcp-server
Weishaupt WEM Portal MCP Server
Управляйте и контролируйте вашу систему отопления Weishaupt с помощью ИИ-ассистентов через WEM Portal
Возможности
Обнаружение устройств — список всех устройств и модулей из вашей учетной записи WEM Portal
Параметры в реальном времени — чтение температур, давления, режимов работы с текущими значениями
Полный обзор — получение полного снимка всей вашей системы отопления одним вызовом
Запись параметров — изменение целевых температур, режимов работы, расписаний
Статус устройства — проверка статуса подключения ваших устройств
Фильтр изменяемых параметров — список только тех параметров, которые вы действительно можете изменить
Управление сессиями — автоматическая авторизация на основе cookie с блокировкой входа для параллельных запросов
Related MCP server: victron-tcp
Быстрый старт
Установка через npx (рекомендуется)
Установка не требуется. Настройте ваш MCP-клиент для запуска:
npx @disane-dev/weishaupt-wem-mcp-serverУстановка из исходного кода
git clone https://github.com/Disane87/weishaupt-wem-mcp-server.git
cd weishaupt-wem-mcp-server
npm install
npm run buildКонфигурация
Добавьте в конфигурацию 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-serverУстановите переменные окружения WEM_USERNAME и WEM_PASSWORD перед запуском.
{
"mcpServers": {
"weishaupt-wem": {
"command": "node",
"args": ["/path/to/wem-mcp/build/index.js"],
"env": {
"WEM_USERNAME": "your_email@example.com",
"WEM_PASSWORD": "your_password"
}
}
}
}Переменные окружения
Переменная | Обязательная | Описание |
| Да | Ваш email для WEM Portal |
| Да | Ваш пароль для WEM Portal |
| Нет | Базовый URL API (по умолчанию: |
Доступные инструменты
Инструмент | Описание |
| Список всех устройств с модулями. Сначала вызовите этот инструмент, чтобы узнать ID. |
| Получить статус подключения устройства |
| Полный обзор устройства: все модули со всеми параметрами за один вызов |
| Получить все параметры модуля с текущими значениями |
| Получить метаданные параметров (имена, мин/макс, перечисления, флаг записи) |
| Список только изменяемых параметров с диапазонами и опциями |
| Прочитать конкретные значения параметров по ID |
| Установить значение параметра (например, целевую температуру) |
[!TIP] Начните с
wem_get_devices, чтобы узнать вашиdeviceId,moduleIndexиmoduleType, затем используйтеwem_get_overviewдля полного снимка вашей системы отопления.
Типичный рабочий процесс
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)Распространенные типы модулей
Тип | Имя | Описание |
1 | SYSTEM | Обзор системы |
2 | HZK | Контур отопления (температуры, режим работы) |
3 | WW | Горячая вода (температура, буст, расписание) |
5 | TERMINAL | Панель управления |
6 | GATEWAY | Шлюз связи |
7 | WE | Теплогенератор (производительность котла/теплового насоса) |
9 | Device | Физическое устройство |
10 | GROUND | Модуль GROUND |
Разработка
Команда | Описание |
| Собрать проект |
| Режим наблюдения (автопересборка при изменениях) |
| Запустить сервер напрямую |
| Проверить подключение к API |
| Официальный MCP Inspector (веб-интерфейс) |
| CLI-инспектор для быстрых проверок API |
Устранение неполадок
[!NOTE] Убедитесь, что вы можете войти на wemportal.com перед использованием этого сервера.
Проблема | Решение |
Ошибка аутентификации | Проверьте учетные данные, убедитесь, что WEM Portal не блокирует после слишком многих попыток |
Тайм-аут соединения | Проверьте интернет, WEM Portal может быть временно недоступен (тайм-аут по умолчанию 30 с) |
Значения параметров равны 0 | Некоторые параметры (например, температура в помещении) требуют физического датчика, подключенного к устройству |
Вклад в проект
Вклад приветствуется! Пожалуйста, создайте issue или отправьте pull request.
Лицензия
MIT — см. LICENSE
disane.dev | Блог | 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