Каталог MCP
Tommertom/plugwise-mcp

Tommertom/plugwise-mcp

Name: Tommertom/plugwise-mcp
Availability: InStock
Author: tommertom

MCP-сервер для управления умным домом Plugwise: автоматически находит хабы в сети, управляет термостатами, розетками и мониторит энергопотребление. Поддерживает несколько шлюзов одновременно и инте...

README

16 инструментов

Версии

Установить сервер

Plugwise MCP Server

A TypeScript-based Model Context Protocol (MCP) server for Plugwise smart home integration with automatic network discovery.

✨ Key Features

🤖 AI Agent Mode: Natural language control via built-in AI agent
📡 JSON-RPC Support: Programmatic API for scripting and automation
🔍 Automatic Network Scanning: Discovers all Plugwise hubs on your network
🔐 Credential Management: Stores hub passwords securely from .env file
🔌 Device Control: Control thermostats, switches, and smart plugs
🌡️ Temperature Management: Set temperatures, presets, and schedules
📊 Energy Monitoring: Read power consumption and sensor data
🏠 Multi-Hub Support: Manage multiple gateways simultaneously
🔄 Real-time Updates: Get current device states and measurements

🚀 Quick Start

Installation via npm (Recommended)

Install globally to use with any MCP client:

npm install -g plugwise-mcp-server

Or use directly with npx (no installation needed):

npx plugwise-mcp-server

Installation from Source

git clone https://github.com/Tommertom/plugwise-mcp-server.git
cd plugwise-mcp-server
npm install
npm run build

Инструменты были проиндексированы: 09.09.2026

add_hub

Добавляет новый хаб Plugwise, указывая его имя (используемое как пароль). Сканирует сеть, находит хаб и сохраняет его в папку /hubs как JSON-файл для последующего использования. Имя хаба - это уникальный идентификатор, напечатанный на задней стороне вашего устройства Plugwise.

Параметры

hubNamestringобязательный
The hub name/ID (e.g., glmpuuxg) which is also used as the password. This is the unique identifier found on the back label of your Plugwise hub.

connect

Подключается к шлюзу Plugwise (Adam, Anna, Smile P1 или Stretch) и получает информацию о шлюзе. Если хост не указан, автоматически подключается к первому обнаруженному хабу. Возвращает подробную информацию о шлюзе: модель, тип, версию, имя хоста и MAC-адрес.

Параметры

hoststring
IP address or hostname of the Plugwise gateway. If omitted, connects to first discovered hub from registry.
passwordstring
Password for the Plugwise gateway (typically the hub name). If omitted and host matches a discovered hub, uses stored password.
portnumber
Port number (default: 80)
usernamestring
Username (default: smile)

control_switch

Включает или выключает переключатель или реле. Работает с переключателями, реле и умными розетками Plugwise. Используйте это для управления любым коммутируемым устройством в вашей сети Plugwise.

Параметры

appliance_idstringобязательный
ID of the appliance/device to control
modelstring
Switch model type (default: relay). Options: relay, switch, plug
stateenumобязательный
Desired state: "on" to turn on, "off" to turn off

delete_notification

Удаляет активное уведомление из шлюза Plugwise. Используется для очистки системных уведомлений, оповещений или предупреждений, отображаемых на шлюзе.

Параметры

Без параметров.

get_all_temperatures

Получает текущие температуры и заданные значения для всех термостатов и зон в системе. Возвращает полные данные о температуре, включая измеренные значения, заданные значения, состояния управления и режимы климата для каждого устройства, способного измерять температуру.

Параметры

Без параметров.

get_devices

Получает все устройства Plugwise и их текущие состояния, датчики и возможности. Возвращает полную информацию обо всех подключенных устройствах, включая термостаты, выключатели, датчики и другие приборы. Включает текущие показания, возможности и рабочие состояния.

Параметры

Без параметров.

get_temperature

Получить текущую температуру в помещении и уставку для конкретного термостата или зоны. Возвращает как измеренную температуру, так и целевую уставку.

Параметры

device_idstringобязательный
ID of the device/zone to read temperature from

get_temperature_offset

Получает смещение температуры (калибровку) для термостата. Смещение используется для калибровки датчика температуры, если он показывает неверно. Возвращает текущее значение смещения и его допустимый диапазон.

Параметры

device_idstringобязательный
ID of the thermostat device to query

list_hubs

Выводит список всех зарегистрированных хабов Plugwise из папки /hubs и реестра в памяти. Возвращает информацию о хабах: имя, IP-адрес, модель и версию прошивки для каждого обнаруженного хаба.

Параметры

Без параметров.

reboot_gateway

Перезагружает шлюз Plugwise (используйте с осторожностью). Это перезапустит шлюз, временно прерывая все управление и мониторинг. Шлюз будет недоступен в течение 1-2 минут. Используйте только при необходимости для устранения неисправностей.

Параметры

Без параметров.

set_dhw_mode

Устанавливает режим нагрева горячей воды (ГВС) для систем с управлением горячим водоснабжением. Автоматический режим следует расписанию, режим ускоренного нагрева обеспечивает немедленный нагрев воды, комфортный режим поддерживает более высокую температуру, а выключенный режим отключает нагрев ГВС.

Параметры

modeenumобязательный
DHW mode: "auto" follows schedule, "boost" for immediate heating, "comfort" for higher temperature, "off" to disable

set_gateway_mode

Устанавливает режим работы шлюза (home, away, vacation). Это общесистемная настройка, которая влияет на все зоны и предустановки. Домашний режим использует обычные расписания, режим отъезда — пониженные температуры, а режим отпуска — минимальное отопление/охлаждение.

Параметры

modeenumобязательный
Gateway mode: "home" for normal operation, "away" for temporary absence, "vacation" for extended absence

set_preset

Устанавливает предустановленный режим на термостате или зоне (например, дом, отсутствие, сон, отпуск). Предустановки применяют заранее заданные температурные настройки и поведение, настроенные в вашей системе Plugwise.

Параметры

location_idstringобязательный
ID of the location/zone to control
presetstringобязательный
Preset name (e.g., home, away, sleep, vacation, no_frost)

set_regulation_mode

Устанавливает режим регулирования отопления. Контролирует общее поведение системы отопления. Используйте "heating" для нормальной работы, "off" для отключения отопления или режимы продувки для обслуживания системы.

Параметры

modeenumобязательный
Regulation mode: "heating" for normal operation, "off" to disable, "bleeding_cold"/"bleeding_hot" for maintenance

set_temperature

Устанавливает заданную температуру на термостате или в зоне. Поддерживает единую заданную температуру для систем отопления/охлаждения или отдельные низкую и высокую заданные температуры для систем с тепловым насосом. Изменения вступают в силу немедленно.

Параметры

location_idstringобязательный
ID of the location/zone to control
setpointnumber
Temperature setpoint in Celsius for single-setpoint systems
setpoint_highnumber
High temperature setpoint (cooling) in Celsius for heat pump systems
setpoint_lownumber
Low temperature setpoint (heating) in Celsius for heat pump systems

set_temperature_offset

Устанавливает смещение (калибровку) температуры для термостатного устройства. Корректирует измеренную температуру на фиксированное смещение.

Параметры

device_idstringобязательный
ID of the thermostat device
offsetnumberобязательный
Temperature offset in °C (can be positive or negative)

Github Сайт сервера

Конфиг для установки сервера

{
  "command": "npx",
  "args": [
    "-y",
    "plugwise-mcp-server@latest"
  ],
  "env": {
    "HUB1": "abc12345",
    "HUB1IP": "192.168.1.100",
    "HUB2": "def67890",
    "HUB2IP": "192.168.1.101"
  }
}

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx

Информация о сервере

Номер в рейтинге: #198
Звезд на Github: 2
Форков на Github: 2
Загрузок: 889
Язык реализации: TypeScript
Лицензия: MIT
Официальный сервер: Нет
Дата обновления данных: 08.09 в 23:44
Идентификатор: iXJvky7gLuzfuFO8
Категории: Автоматизация приложений, Инструменты для разработчиков, Командная строка, Мониторинг, Умный дом и IoT