Home Assistant MCP Server

Co dělá „Home Assistant“ MCP Server?

Home Assistant MCP Server (hass-mcp) je server Model Context Protocol (MCP), který propojuje AI asistenty – jako je Claude a další LLM – s vaším ekosystémem Home Assistant. Díky zpřístupnění dat a funkcí Home Assistant přes standard MCP umožňuje AI agentům interagovat, dotazovat se a ovládat chytrá domácí zařízení a automatizace. Typické úkoly umožněné hass-mcp zahrnují dotazování stavů zařízení a senzorů, přepínání světel či spínačů, sumarizaci stavu domácnosti, ladění automatizací, vyhledávání konkrétních entit a vedení strukturovaných konverzací pro běžné domácí činnosti. Tato integrace zjednodušuje práci vývojářů i uživatelů tím, že zpřístupňuje správu chytré domácnosti pomocí konverzační AI, automatizací i LLM agentů.

Seznam promptů

• V repozitáři nebyly nalezeny žádné šablony promptů.

Seznam zdrojů

• V repozitáři nebyly uvedeny žádné explicitní MCP zdroje.

Seznam nástrojů

• Dotazování na stav zařízení a senzorů: Umožňuje LLM získat aktuální stav entit Home Assistant.
• Ovládání světel, spínačů a dalších entit: Umožňuje přímé ovládání (zapnutí/vypnutí, jas apod.) podporovaných chytrých komponent.
• Získání souhrnů domácnosti: Poskytuje přehledy nebo agregované informace o aktuálním stavu domácnosti.
• Ladění automatizací a entit: Nabízí diagnostiku nebo kroky k řešení problémů s automatizacemi či zařízeními.
• Vyhledávání konkrétních entit: Umožňuje uživatelům i agentům najít zařízení nebo senzory podle názvu či typu v Home Assistant.
• Tvorba řízených konverzací pro běžné úkoly: Podporuje strukturované interakce, které uživatele provedou běžnými domácími operacemi.

Příklady použití tohoto MCP serveru

• Dotazování stavů zařízení: Vývojáři i uživatelé mohou programově či konverzačně zjistit aktuální stavy (například „Je kuchyňské okno otevřené?“), což podporuje monitoring i automatizaci.
• Ovládání chytré domácnosti: Umožňuje hlasovým asistentům nebo chatbotům zapínat/vypínat světla, nastavovat termostaty nebo ovládat spotřebiče a tím rozšiřuje dostupnost a automatizaci.
• Souhrnné reporty domácnosti: LLM mohou generovat denní nebo ad-hoc souhrny (například „Jaký je stav mé domácnosti dnes večer?“) pro pohodlí uživatele nebo integraci do dashboardů.
• Ladění automatizací: Vývojáři mohou s pomocí MCP serveru identifikovat chyby v automatizacích a zefektivnit ladění.
• Vyhledávání entit a řízené úlohy: Rychlé vyhledání zařízení či provedení uživatele složitějšími více-krokovými rutinami (například „Nastav ranní rutinu“) usnadní správu chytré domácnosti.

Jak to nastavit

Windsurf

1. Ujistěte se, že máte na systému nainstalovaný Python a Docker.
2. Naklonujte repozitář hass-mcp a nastavte připojení k Home Assistant v souboru .env (viz .env.example).
3. Ve Windsurfu otevřete sekci MCP Servers v nastavení.
4. Přidejte server hass-mcp pomocí JSON konfigurace jako:

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

5. Uložte nastavení a restartujte Windsurf. Ověřte, že se server objeví v seznamu MCP.

Claude

1. Nasazení serveru hass-mcp lokálně nebo na server dostupný pro Claude.
2. Zabezpečte svůj API klíč Home Assistant pomocí proměnných prostředí.
3. V konfiguraci Claude přidejte záznam MCP serveru:

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

4. Restartujte Claude a zkontrolujte dostupnost MCP serveru.
5. K zabezpečení citlivých dat používejte proměnné prostředí (viz níže).

Cursor

1. Nasadťe hass-mcp a zajistěte síťový přístup mezi Cursor a MCP serverem.
2. Nakonfigurujte Cursor pro použití MCP serveru:

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

3. Uložte konfiguraci a restartujte Cursor.
4. Nastavte proměnné prostředí pro API klíče dle potřeby.

Cline

1. Nainstalujte závislosti a spusťte server hass-mcp (viz repozitář pro podrobnosti).
2. V Cline otevřete svůj konfigurační soubor MCP.
3. Přidejte server hass-mcp:

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

4. Restartujte Cline pro zpřístupnění nového MCP serveru.

Zabezpečení API klíčů (všechny platformy):

Používejte proměnné prostředí v konfiguraci pro ochranu citlivých údajů:

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

Jak tento MCP použít ve flow

Použití MCP ve FlowHunt

Pro integraci MCP serverů do svého workflowu ve FlowHunt začněte přidáním MCP komponenty do flow a propojte ji se svým AI agentem:

Klikněte na MCP komponentu pro otevření konfiguračního panelu. V sekci systémové konfigurace MCP vložte údaje o serveru v tomto JSON formátu:

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

Po nastavení může AI agent tento MCP používat jako nástroj se všemi jeho funkcemi a možnostmi. Nezapomeňte změnit “hass-mcp” na skutečný název vašeho MCP serveru a upravit URL na adresu vašeho serveru.

Přehled

Na základě dostupné dokumentace a obsahu repozitáře poskytuje hass-mcp solidní základ pro integraci Home Assistant přes MCP s jasnou podporou nástrojů a smysluplnými doporučeními pro nastavení i zabezpečení. Chybí však explicitní šablony promptů, definice zdrojů nebo pokročilé sampling/roots funkce v otevřené dokumentaci. MCP server hodnotím na 6/10: funkční a vhodný pro vývojáře, ale postrádá dokumentaci k rozšiřitelnosti a pokročilým MCP vlastnostem.

MCP skóre