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

Tommertom/plugwise-mcp

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

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

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

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

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

add_hub

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

Параметры

hubNamestringобязательный
Имя/идентификатор хаба (например, glmpuuxg) также используется в качестве пароля. Это уникальный идентификатор, указанный на наклейке с обратной стороны вашего хаба Plugwise.

connect

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

Параметры

hoststring
IP-адрес или имя хоста шлюза Plugwise. Если не указано, подключается к первому обнаруженному концентратору из реестра.
passwordstring
Пароль для шлюза Plugwise (обычно имя хаба). Если пароль не указан и хост совпадает с обнаруженным хабом, используется сохранённый пароль.
portnumber
Номер порта (по умолчанию: 80)
usernamestring
Имя пользователя (по умолчанию: smile)

control_switch

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

Параметры

appliance_idstringобязательный
Идентификатор прибора/устройства для управления
modelstring
Переключает тип модели (по умолчанию: relay). Варианты: relay, switch, plug
stateenumобязательный
Желаемое состояние: "on" для включения, "off" для выключения.

delete_notification

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

Параметры

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

get_all_temperatures

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

Параметры

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

get_devices

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

Параметры

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

get_temperature

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

Параметры

device_idstringобязательный
ID устройства/зоны, откуда считывается температура.

get_temperature_offset

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

Параметры

device_idstringобязательный
ID термостатного устройства, которое нужно опросить

list_hubs

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

Параметры

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

reboot_gateway

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

Параметры

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

set_dhw_mode

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

Параметры

modeenumобязательный
Режим DHW: «auto» следует расписанию, «boost» для немедленного нагрева, «comfort» для повышенной температуры, «off» для отключения.

set_gateway_mode

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

Параметры

modeenumобязательный
Режим шлюза: "home" для обычной работы, "away" для временного отсутствия, "vacation" для длительного отсутствия.

set_preset

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

Параметры

location_idstringобязательный
ID местоположения/зоны для управления
presetstringобязательный
Название пресета (например, home, away, sleep, vacation, no_frost)

set_regulation_mode

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

Параметры

modeenumобязательный
Режим регулирования: "heating" для нормальной работы, "off" для отключения, "bleeding_cold"/"bleeding_hot" для обслуживания.

set_temperature

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

Параметры

location_idstringобязательный
ID местоположения/зоны для управления
setpointnumber
Уставка температуры в градусах Цельсия для систем с одной уставкой
setpoint_highnumber
Уставка высокой температуры (охлаждение) в градусах Цельсия для систем с тепловым насосом.
setpoint_lownumber
Уставка низкой температуры (нагрев) в градусах Цельсия для систем тепловых насосов.

set_temperature_offset

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

Параметры

device_idstringобязательный
ID термостатного устройства
offsetnumberобязательный
Смещение температуры в °C (может быть положительным или отрицательным)

`1.0.10`основная	07.11.2025
`1.0.9`	06.11.2025
`1.0.8`	04.11.2025
`1.0.7`	04.11.2025
`1.0.6`	26.10.2025
`1.0.5`	23.10.2025
`1.0.4`	16.10.2025
`1.0.3`	16.10.2025
`1.0.2`	14.10.2025
`1.0.1`	14.10.2025
`1.0.0`	14.10.2025

Выберите клиент, чтобы установить Tommertom/plugwise-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

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

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

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

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

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

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"tommertom-plugwise-mcp-c2kvm9okti\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"plugwise-mcp-server@latest\"],\"env\":{\"HUB1\":\"abc12345\",\"HUB1IP\":\"192.168.1.100\",\"HUB2\":\"def67890\",\"HUB2IP\":\"192.168.1.101\"}}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

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

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add tommertom-plugwise-mcp-c2kvm9okti --env HUB1=abc12345 --env HUB1IP=192.168.1.100 --env HUB2=def67890 --env HUB2IP=192.168.1.101 -- npx -y plugwise-mcp-server@latest

Либо через JSON-конфиг:

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

Codex

Добавьте сервер командой в терминале:

codex mcp add tommertom-plugwise-mcp-c2kvm9okti --env HUB1=abc12345 --env HUB1IP=192.168.1.100 --env HUB2=def67890 --env HUB2IP=192.168.1.101 -- npx -y plugwise-mcp-server@latest

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.tommertom-plugwise-mcp-c2kvm9okti]
command = "npx"
args = ["-y", "plugwise-mcp-server@latest"]

[mcp_servers.tommertom-plugwise-mcp-c2kvm9okti.env]
HUB1 = "abc12345"
HUB1IP = "192.168.1.100"
HUB2 = "def67890"
HUB2IP = "192.168.1.101"

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите Tommertom/plugwise-mcp, а в поле команды запуска — строку ниже:

npx -y plugwise-mcp-server@latest

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

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

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

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

Continue

Создайте файл в .continue/mcpServers/ (например tommertom-plugwise-mcp-c2kvm9okti.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: tommertom-plugwise-mcp-c2kvm9okti
    command: npx
    args:
      - "-y"
      - "plugwise-mcp-server@latest"
    env:
      HUB1: abc12345
      HUB1IP: 192.168.1.100
      HUB2: def67890
      HUB2IP: 192.168.1.101

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

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

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

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