Home Assistant MCP Server

Čo robí “Home Assistant” MCP server?

Home Assistant MCP Server (hass-mcp) je server Model Context Protocol (MCP), ktorý prepája AI asistentov – ako Claude či iné LLM modely – s vaším ekosystémom Home Assistant. Sprístupnením dát a funkcií Home Assistant cez MCP štandard umožňuje AI agentom interagovať, dotazovať sa a ovládať inteligentné zariadenia a automatizácie. Typické úlohy, ktoré hass-mcp umožňuje, zahŕňajú zisťovanie stavov zariadení a senzorov, prepínanie svetiel alebo spínačov, sumarizáciu stavu domácnosti, riešenie problémov s automatizáciami, vyhľadávanie konkrétnych entít a vedenie používateľov cez sprievodcovské konverzácie pre bežné úkony v inteligentnej domácnosti. Táto integrácia zlepšuje vývojárske aj používateľské toky práce tým, že spravovanie domácnosti je dostupné prostredníctvom konverzačnej AI, automatizácií a agentov poháňaných LLM.

Zoznam promptov

• V repozitári neboli nájdené žiadne dokumentované šablóny promptov.

Zoznam zdrojov

• V repozitári nie sú uvedené žiadne explicitné MCP zdroje.

Zoznam nástrojov

• Dotazovanie na stav zariadení a senzorov: Umožňuje LLM modelom získať aktuálny stav entít v Home Assistant.
• Ovládanie svetiel, spínačov a ďalších entít: Priame ovládanie (zapnúť/vypnúť, jas a pod.) podporovaných zariadení inteligentnej domácnosti.
• Získavanie sumárov domácnosti: Poskytuje prehľady alebo agregované informácie o aktuálnom stave domácnosti.
• Riešenie problémov s automatizáciami a entitami: Ponúka diagnostiku alebo kroky na vyriešenie problémov s automatizáciami či entitami.
• Vyhľadávanie konkrétnych entít: Umožňuje používateľom alebo agentom nájsť zariadenia alebo senzory podľa názvu či typu v Home Assistant.
• Vytváranie sprievodcovských konverzácií pre bežné úkony: Podporuje štruktúrované interakcie, ktoré používateľa prevedú častými činnosťami v domácnosti.

Príklady využitia tohto MCP servera

• Dotazovanie stavov zariadení: Vývojári aj používatelia môžu programovo či konverzačne získať aktuálne stavy (napr. „Je kuchynské okno otvorené?“), čo podporuje monitoring aj logiku automatizácií.
• Ovládanie inteligentnej domácnosti: Hlasoví asistenti alebo chatboty môžu zapínať/vypínať svetlá, nastavovať termostaty alebo ovládať spotrebiče, čím zvyšujú dostupnosť aj automatizáciu.
• Sumárne prehľady domácnosti: LLM modely môžu generovať denné alebo ad-hoc sumáre (napr. „Aký je stav mojej domácnosti dnes večer?“) pre pohodlie používateľa či integráciu do dashboardov.
• Riešenie problémov s automatizáciami: Vývojári môžu cez MCP server identifikovať zlé nastavenia alebo chyby v automatizáciách a zrýchliť ladenie.
• Vyhľadávanie entít & sprievodcovské úlohy: Rýchle vyhľadanie zariadení alebo vedenie používateľa cez zložitejšie viacstupňové rutiny (napr. „Nastav rannú rutinu“) zjednodušuje správu domácnosti.

Ako to nastaviť

Windsurf

1. Uistite sa, že vo vašom systéme máte nainštalovaný Python a Docker.
2. Naklonujte repozitár hass-mcp a nakonfigurujte pripojenie na Home Assistant v súbore .env (pozrite .env.example).
3. Vo Windsurf otvorte časť Nastavenia → MCP servery.
4. Pridajte server hass-mcp pomocou JSON konfigurácie napríklad:

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

5. Uložte nastavenia a reštartujte Windsurf. Overte, že server sa zobrazuje v MCP zozname.

Claude

1. Nasadzujte server hass-mcp lokálne alebo na server dostupný pre Claude.
2. Zaistite bezpečnosť vášho Home Assistant API kľúča pomocou premenných prostredia.
3. V konfigurácii Claude pridajte záznam MCP servera:

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

4. Reštartujte Claude a skontrolujte dostupnosť MCP servera.
5. Na zabezpečenie citlivých údajov používajte premenné prostredia (viď nižšie).

Cursor

1. Nasadte hass-mcp a zaistite sieťový prístup medzi Cursor a MCP serverom.
2. Konfigurujte Cursor na použitie MCP servera:

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

3. Uložte konfiguráciu a reštartujte Cursor.
4. Nastavte premenné prostredia pre API kľúče podľa potreby.

Cline

1. Nainštalujte závislosti a spustite server hass-mcp (pozrite repozitár pre detaily).
2. V Cline otvorte svoj konfiguračný súbor MCP.
3. Pridajte server hass-mcp:

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

4. Reštartujte Cline pre aktiváciu nového MCP servera.

Zabezpečenie API kľúčov (všetky platformy):

Použite premenné prostredia vo vašej konfigurácii na ochranu citlivých údajov:

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

Ako použiť tento MCP vo flow

Použitie MCP vo FlowHunt

Na integráciu MCP serverov do vašich FlowHunt tokov najprv pridajte MCP komponent do toku a prepojte ho s AI agentom:

Kliknite na MCP komponent pre otvorenie konfiguračného panela. V systémovej MCP konfigurácii vložte detaily MCP servera v tomto JSON formáte:

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

Po nakonfigurovaní môže AI agent tento MCP využívať ako nástroj so všetkými jeho funkciami a možnosťami. Nezabudnite zmeniť “hass-mcp” na skutočný názov vášho MCP servera a URL na adresu vášho MCP servera.

Prehľad

Na základe dostupnej dokumentácie a obsahu repozitára poskytuje hass-mcp solídny základ pre integráciu Home Assistant cez MCP, s jasnou podporou nástrojov a rozumnými postupmi nastavenia a zabezpečenia. Chýbajú však explicitné šablóny promptov, definície zdrojov alebo pokročilé sampling/roots vlastnosti v verejnej dokumentácii. Tento MCP server by som hodnotil 6/10: funkčný a priateľský pre vývojárov, no chýba rozšíriteľná dokumentácia a pokročilé MCP funkcie.

MCP skóre