loxone-mcp

Ein MCP-Server (Model Context Protocol), der KI-Assistenten mit einem Loxone Miniserver Smart-Home-System verbindet.

Ermöglicht es Claude (oder jeder anderen MCP-kompatiblen KI), Räume aufzulisten, Live-Sensor-/Aktorzustände abzufragen, Geräte zu suchen und Befehle zu senden.

Funktionen

• list_rooms — alle Räume mit ihren Steuerungen

• list_controls — alle Steuerungen (Name, Typ, UUID, Raum)

• find_control — Stichwortsuche über Name/Raum/Typ

• get_status — Live-Sensor- und Aktorwerte (optionaler Raumfilter)

• control_device — Befehle senden (Ein/Aus, Dimmer %, Jalousien, HLK, Audio)

Related MCP server: Loxone MCP Server

Anforderungen

• Loxone Miniserver mit aktiviertem Cloud Connect

• Node.js 20+ (oder Docker)

Installation

npm

npm install -g @syntropic/loxone-mcp

Anschließend mit gesetzten Umgebungsvariablen ausführen:

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

Aus dem Quellcode

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

Der Server lauscht auf http://localhost:3000. Der MCP-Endpunkt ist POST /mcp.

Docker

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

Konfiguration

Verbindung mit Claude herstellen

Fügen Sie dies zu Ihrer Claude MCP-Konfiguration hinzu:

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

Unterstützte Befehle nach Gerätetyp

Architektur

• Zustandsfreier HTTP-Server – jeder POST /mcp erstellt einen neuen Transport (kein Sitzungsstatus)

• Loxone Cloud Connect: Löst die aktuelle Tunnel-URL bei jeder Anfrage über dns.loxonecloud.com auf

• Struktur-Cache: Loxone App-Struktur (LoxAPP3.json) wird für 60 Sekunden zwischengespeichert

Lizenz

MIT