Home Assistant MCP-server

Wat doet de “Home Assistant” MCP-server?

Home Assistant MCP Server (hass-mcp) is een Model Context Protocol (MCP)-server die AI-assistenten—zoals Claude en andere LLM’s—verbindt met je Home Assistant-ecosysteem. Door de gegevens en functionaliteiten van Home Assistant via de MCP-standaard beschikbaar te stellen, stelt het AI-agenten in staat om te communiceren met, op te vragen en slimme apparaten en automatiseringen te bedienen. Typische taken die mogelijk zijn met hass-mcp zijn onder andere het opvragen van apparaat- en sensorstatussen, het schakelen van lampen of schakelaars, het samenvatten van de huishoudstatus, het oplossen van problemen met automatiseringen, het zoeken naar specifieke entiteiten en het faciliteren van begeleide conversaties voor veelvoorkomende smart home-activiteiten. Deze integratie verbetert de workflows van ontwikkelaars en gebruikers door het beheer van de slimme woning toegankelijk te maken via conversatie-AI, automatiseringen en LLM-gestuurde agenten.

Lijst met prompts

• Er zijn geen gedocumenteerde prompt-sjablonen gevonden in de repository.

Lijst met bronnen

• Er zijn geen expliciete MCP-bronnen vermeld in de repository.

Lijst met tools

• Status van apparaten en sensoren opvragen: Hiermee kunnen LLM’s de huidige status van Home Assistant-entiteiten ophalen.
• Bedien lampen, schakelaars en andere entiteiten: Maakt directe bediening mogelijk (aan/uit, helderheid, etc.) van ondersteunde slimme componenten.
• Samenvattingen van je slimme woning ophalen: Geeft overzicht of samengevatte informatie over de huidige status van de woning.
• Automatiseringen en entiteiten troubleshooten: Biedt diagnostische informatie of stappen om problemen met automatiseringen of entiteiten op te lossen.
• Specifieke entiteiten zoeken: Laat gebruikers of agenten apparaten of sensoren vinden op naam of type binnen Home Assistant.
• Begeleide conversaties voor veelvoorkomende taken creëren: Ondersteunt gestructureerde interacties om gebruikers door veelgebruikte smart home-handelingen te leiden.

Gebruikstoepassingen van deze MCP-server

• Apparaatstatus opvragen: Ontwikkelaars en gebruikers kunnen programmatisch of via conversatie de actuele status opvragen (bijv. “Staat het keukenraam open?”), ter ondersteuning van monitoring en automatiseringslogica.
• Smart Home-bediening: Maakt het mogelijk voor spraakassistenten of chatbots om lampen aan/uit te zetten, thermostaten te regelen of apparaten te bedienen, wat toegankelijkheid en automatisering vergroot.
• Statusrapporten van de woning: LLM’s kunnen dagelijkse of op aanvraag samenvattingen genereren (bijv. “Wat is de status van mijn huis vanavond?”) voor gebruiksgemak of dashboardintegratie.
• Automatiseringen troubleshooten: Ontwikkelaars kunnen de MCP-server gebruiken om verkeerde configuraties of fouten in automatiseringen te identificeren, wat het debuggen versnelt.
• Entiteiten zoeken & begeleide taakstromen: Snel apparaten lokaliseren of gebruikers door complexe meerstapsroutines leiden (bijv. “Stel een ochtendroutine in”) vereenvoudigt smart home-beheer.

Hoe stel je het in

Windsurf

1. Zorg dat Python en Docker op je systeem zijn geïnstalleerd.
2. Clone de hass-mcp-repository en configureer je Home Assistant-verbinding in een .env-bestand (zie .env.example).
3. Open in Windsurf het gedeelte MCP Servers in je instellingen.
4. Voeg de hass-mcp-server toe met een JSON-configuratie zoals:

   {
     "mcpServers": {
       "hass-mcp": {
         "command": "docker",
         "args": ["run", "--env-file=.env", "-p", "8080:8080", "voska/hass-mcp:latest"]
       }
     }
   }
   

5. Sla de instellingen op en herstart Windsurf. Controleer of de server in de MCP-lijst verschijnt.

Claude

1. Zet de hass-mcp-server lokaal of op een server die toegankelijk is voor Claude.
2. Beveilig je Home Assistant API-sleutel met omgevingsvariabelen.
3. Voeg in de configuratie van Claude de MCP-server toe:

   {
     "mcpServers": {
       "hass-mcp": {
         "command": "python",
         "args": ["-m", "app.main"]
       }
     }
   }
   

4. Herstart Claude en controleer de beschikbaarheid van de MCP-server.
5. Gebruik omgevingsvariabelen om gevoelige gegevens te beveiligen (zie hieronder).

Cursor

1. Zet hass-mcp op en zorg voor netwerktoegang tussen Cursor en de MCP-server.
2. Configureer Cursor om de MCP-server te gebruiken:

   {
     "mcpServers": {
       "hass-mcp": {
         "command": "python",
         "args": ["-m", "app.main"]
       }
     }
   }
   

3. Sla de configuratie op en herstart Cursor.
4. Stel waar nodig omgevingsvariabelen in voor API-sleutels.

Cline

1. Installeer afhankelijkheden en start de hass-mcp-server (zie repository voor details).
2. Open in Cline je MCP-configuratiebestand.
3. Voeg de hass-mcp-server toe:

   {
     "mcpServers": {
       "hass-mcp": {
         "command": "python",
         "args": ["-m", "app.main"]
       }
     }
   }
   

4. Herstart Cline om de nieuwe MCP-server te activeren.

API-sleutels beveiligen (alle platformen):

Gebruik omgevingsvariabelen in je configuratie om gevoelige informatie te beschermen:

{
  "mcpServers": {
    "hass-mcp": {
      "env": {
        "HASS_TOKEN": "${HASS_TOKEN}"
      },
      "inputs": {
        "hass_url": "http://your-homeassistant.local:8123"
      }
    }
  }
}

Hoe gebruik je deze MCP in flows

MCP gebruiken in FlowHunt

Om MCP-servers in je FlowHunt-workflow te integreren, begin je met het toevoegen van het MCP-component aan je flow en deze te verbinden met je AI-agent:

Klik op het MCP-component om het configuratiescherm te openen. Voeg in het systeem-MCP-configuratiegedeelte je MCP-servergegevens toe met dit JSON-formaat:

{
  "hass-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Na configuratie kan de AI-agent deze MCP nu als tool gebruiken met toegang tot alle functies en mogelijkheden. Vergeet niet “hass-mcp” te vervangen door de daadwerkelijke naam van jouw MCP-server en de URL te wijzigen naar die van jouw eigen MCP-server.

Overzicht

Op basis van de beschikbare documentatie en repository-inhoud biedt hass-mcp een solide basis voor Home Assistant-integratie via MCP, met duidelijke toolondersteuning en verstandige installatie-/beveiligingspraktijken. Er ontbreekt echter expliciete documentatie voor prompt-sjablonen, resource-definities of geavanceerde sampling/roots-functionaliteit in de openbare documentatie. Ik geef deze MCP-server een 6/10: functioneel en gebruiksvriendelijk voor ontwikkelaars, maar met een gebrek aan uitbreidingsdocumentatie en geavanceerde MCP-functies.

MCP-score