loxone-mcp

MCP-сервер (Model Context Protocol), который подключает ИИ-ассистентов к системе умного дома Loxone Miniserver.

Позволяет Claude (или любому другому ИИ, совместимому с MCP) просматривать список комнат, запрашивать текущие состояния датчиков/актуаторов, искать устройства и отправлять команды.

Возможности

• list_rooms — все комнаты с их элементами управления

• list_controls — все элементы управления (имя, тип, UUID, комната)

• find_control — поиск по ключевым словам в имени/комнате/типе

• get_status — текущие значения датчиков и актуаторов (опциональный фильтр по комнате)

• control_device — отправка команд (Вкл/Выкл, яркость в %, жалюзи, ОВК, аудио)

Related MCP server: Loxone MCP Server

Требования

• Loxone Miniserver с включенным Cloud Connect

• Node.js 20+ (или Docker)

Установка

npm

npm install -g @syntropic/loxone-mcp

Затем запустите с установленными переменными окружения:

LOXONE_SERIAL=XXXXXXXXXXXX \
LOXONE_USER=admin \
LOXONE_PASS=yourpass \
MCP_API_KEY=$(openssl rand -hex 32) \
loxone-mcp

Из исходного кода

git clone https://github.com/syntropicsignal-ai/loxone-mcp.git
cd loxone-mcp
cp .env.example .env
# edit .env with your Miniserver serial, credentials, and a random API key
npm install
npm run build
npm start

Сервер прослушивает http://localhost:3000. Эндпоинт MCP — POST /mcp.

Docker

docker build -t loxone-mcp .
docker run -p 3000:3000 --env-file .env loxone-mcp

Конфигурация

Подключение к Claude

Добавьте в конфигурацию MCP Claude:

{
  "mcpServers": {
    "loxone": {
      "url": "https://your-server/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_API_KEY"
      }
    }
  }
}

Поддерживаемые команды по типу устройства

Архитектура

• HTTP-сервер без сохранения состояния — каждый запрос POST /mcp создает новый транспорт (состояние сессии не сохраняется)

• Loxone Cloud Connect: разрешает текущий URL туннеля через dns.loxonecloud.com при каждом запросе

• Кэш структуры: структура приложения Loxone (LoxAPP3.json) кэшируется на 60 секунд

Лицензия

MIT