mcp-ha: ein MCP-Server für Home Assistant als Add-on

Dieses Add-on für Home Assistant stellt einen MCP (Model Context Protocol) Server bereit. In der Praxis: Du verbindest Claude, Gemini oder einen beliebigen anderen MCP-Client mit deiner Instanz und sprichst mit deinem Zuhause.

„Welche Lichter wurden angelassen?“, „Warum hat die Heizungsautomatisierung letzte Nacht nicht ausgelöst?“, „Stelle meinen Energieverbrauch für die Woche grafisch dar.“

Dokumentation: devitek.github.io/mcp-ha (Englisch und Französisch)

Was es abdeckt

Insgesamt 16 Tools, die darauf ausgelegt sind, das LLM-Kontextfenster zu schonen: kompakte, paginierte und begrenzte Antworten, mit Hinweisen, die den Assistenten zu präziseren Abfragen führen.

Related MCP server: hass-mcp

Warum nicht die offizielle HA-MCP-Integration?

Sie existiert und funktioniert, aber sie läuft über die Assist API: nur Entitäten, die für Assist freigeschaltet sind, kein Verlauf, keine Registries, keine Add-ons, keine Automatisierungskonfigurationen. Dieses Add-on bietet direkten, granularen Zugriff. Beide können koexistieren.

Installation

Voraussetzungen: Home Assistant OS oder Supervised (das Add-on benötigt den Supervisor).

1. Füge dieses Repository zu deinen Add-on-Repositories hinzu:

   

   Oder manuell: Einstellungen, Add-ons, Add-on-Store, Drei-Punkte-Menü, Repositories, und füge dann https://github.com/Devitek/mcp-ha ein.

2. Installiere „MCP Home Assistant“ und starte es.

3. Öffne den Reiter „Konfiguration“ des Add-ons: Beim ersten Start wurde ein API-Token generiert und dort gespeichert (es wird auch im Add-on-Protokoll ausgegeben).

Einen Client verbinden

Claude Code:

claude mcp add --transport http home-assistant \
  http://HA_IP:9583/mcp \
  --header "Authorization: Bearer YOUR_TOKEN"

Claude Desktop und Gemini CLI: siehe den Clients-Leitfaden auf der Dokumentationsseite.

Sicherheit, kurz

• Standardmäßig schreibgeschützt. Das Dienstaufruf-Tool existiert für den Client nicht einmal, es sei denn, du aktivierst allow_write.

• Mehrschichtige Verteidigung bei aktivierten Schreibzugriffen: Denylist gefährlicher Dienste (HA shutdown, shell_command...), Glob-Allow-/Deny-Listen für Entitäten, dry_run-Modus, JSON-Audit-Trail jedes Versuchs im Log.

• Nur LAN. Kein TLS, kein OAuth: Setze Port 9583 nicht dem Internet aus.

Das vollständige Bedrohungsmodell findest du in SECURITY.md.

Dokumentation

• Dokumentationsseite: Installation, Konfiguration, Clients, Tool-Referenz, Architektur (Englisch und Französisch)

• Add-on-Dokumentation: die Seite, die in der HA-Oberfläche angezeigt wird

• Beitragsleitfaden: Entwicklungs-Setup, Konventionen, Releases

• Repository-Issues: die Wissensbasis des Projekts; jede Designentscheidung und jede Stolperfalle wird dort mit den Labels décision und écueil festgehalten (auf Französisch)

Lizenz

MIT