Home Assistant MCP Server

Co robi serwer “Home Assistant” MCP?

Home Assistant MCP Server (hass-mcp) to serwer Model Context Protocol (MCP), który łączy asystentów AI — takich jak Claude i inne LLM — z Twoim ekosystemem Home Assistant. Udostępniając dane i funkcjonalności Home Assistant w standardzie MCP, umożliwia agentom AI interakcję, zapytania i sterowanie urządzeniami oraz automatyzacjami inteligentnego domu. Typowe zadania obsługiwane przez hass-mcp obejmują zapytania o stany urządzeń i sensorów, przełączanie światła lub przełączników, podsumowania stanu domu, diagnozowanie automatyzacji, wyszukiwanie konkretnych encji oraz prowadzone rozmowy dla najczęstszych czynności w inteligentnym domu. Ta integracja usprawnia pracę deweloperów i użytkowników, czyniąc zarządzanie inteligentnym domem dostępnym przez konwersacyjną AI, automatyzacje i agentów LLM.

Lista promptów

• Nie znaleziono udokumentowanych szablonów promptów w repozytorium.

Lista zasobów

• W repozytorium nie znaleziono jawnych zasobów MCP.

Lista narzędzi

• Zapytania o stan urządzeń i sensorów: Pozwala LLM pobierać bieżący status encji Home Assistant.
• Sterowanie światłami, przełącznikami i innymi encjami: Umożliwia bezpośrednie sterowanie (włącz/wyłącz, jasność itd.) obsługiwanymi komponentami inteligentnego domu.
• Uzyskiwanie podsumowań Twojego domu: Dostarcza ogólne przeglądy lub zagregowane informacje o bieżącym stanie domu.
• Diagnozowanie automatyzacji i encji: Oferuje informacje diagnostyczne lub kroki rozwiązywania problemów z automatyzacjami lub urządzeniami.
• Wyszukiwanie konkretnych encji: Pozwala użytkownikom lub agentom odnajdywać urządzenia lub sensory po nazwie lub typie w Home Assistant.
• Tworzenie prowadzonych dialogów dla typowych zadań: Wspiera ustrukturyzowane interakcje, by przeprowadzić użytkownika przez częste czynności w inteligentnym domu.

Przykładowe zastosowania tego serwera MCP

• Zapytania o stan urządzeń: Deweloperzy i użytkownicy mogą programistycznie lub konwersacyjnie uzyskać aktualny stan (np. „Czy okno w kuchni jest otwarte?”), wspierając monitoring i logikę automatyzacji.
• Sterowanie inteligentnym domem: Umożliwia asystentom głosowym lub chatbotom włączanie/wyłączanie świateł, regulację termostatów czy sterowanie urządzeniami, podnosząc wygodę i automatyzację.
• Raporty podsumowania domu: LLM mogą generować codzienne lub na żądanie podsumowania (np. „Jaki jest wieczorny status mojego domu?”) dla wygody użytkownika lub integracji z dashboardami.
• Diagnozowanie automatyzacji: Deweloperzy mogą wykorzystać serwer MCP do identyfikacji błędów lub nieprawidłowych konfiguracji automatyzacji, usprawniając debugowanie.
• Wyszukiwanie encji i prowadzone działania: Szybkie odnajdywanie urządzeń lub przeprowadzanie użytkowników przez złożone, wieloetapowe rutyny (np. „Ustaw poranną rutynę”) upraszcza zarządzanie domem.

Jak skonfigurować

Windsurf

1. Upewnij się, że na Twoim systemie są zainstalowane Python oraz Docker.
2. Sklonuj repozytorium hass-mcp i skonfiguruj połączenie z Home Assistant w pliku .env (zobacz .env.example).
3. W Windsurf otwórz sekcję MCP Servers w ustawieniach.
4. Dodaj serwer hass-mcp używając konfiguracji JSON podobnej do:

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

5. Zapisz ustawienia i zrestartuj Windsurf. Zweryfikuj, czy serwer pojawił się na liście MCP.

Claude

1. Uruchom serwer hass-mcp lokalnie lub na serwerze dostępnym dla Claude.
2. Zabezpiecz klucz API Home Assistant za pomocą zmiennych środowiskowych.
3. W konfiguracji Claude dodaj wpis MCP server:

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

4. Zrestartuj Claude i sprawdź dostępność serwera MCP.
5. Używaj zmiennych środowiskowych do ochrony wrażliwych danych (patrz niżej).

Cursor

1. Uruchom hass-mcp i upewnij się, że Cursor ma dostęp sieciowy do serwera MCP.
2. Skonfiguruj Cursor, aby korzystał z serwera MCP:

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

3. Zapisz konfigurację i zrestartuj Cursor.
4. Ustaw zmienne środowiskowe dla kluczy API w razie potrzeby.

Cline

1. Zainstaluj zależności i uruchom serwer hass-mcp (szczegóły w repozytorium).
2. W Cline otwórz swój plik konfiguracyjny MCP.
3. Dodaj serwer hass-mcp:

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

4. Zrestartuj Cline, aby włączyć nowy serwer MCP.

Zabezpieczanie kluczy API (wszystkie platformy):

Użyj zmiennych środowiskowych w konfiguracji, aby chronić wrażliwe informacje:

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

Jak używać tego MCP w flow

Używanie MCP w FlowHunt

Aby zintegrować serwery MCP z przepływem pracy w FlowHunt, rozpocznij od dodania komponentu MCP do swojego flow i podłączenia go do agenta AI:

Kliknij komponent MCP, aby otworzyć panel konfiguracyjny. W sekcji konfiguracji systemowego MCP wprowadź dane serwera MCP w takim formacie JSON:

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

Po skonfigurowaniu agent AI może już korzystać z MCP jako narzędzia ze wszystkimi jego funkcjami i możliwościami. Pamiętaj, aby zmienić “hass-mcp” na właściwą nazwę swojego serwera MCP i podać swój adres URL serwera MCP.

Podsumowanie

Na podstawie dostępnej dokumentacji i zawartości repozytorium, hass-mcp stanowi solidną podstawę do integracji Home Assistant przez MCP, z jasnym wsparciem narzędzi oraz sensowną konfiguracją i bezpieczeństwem. Brakuje jednak jawnych szablonów promptów, definicji zasobów czy zaawansowanych funkcji MCP w publicznej dokumentacji. Oceniam ten serwer MCP na 6/10: funkcjonalny i przyjazny deweloperom, ale z brakami w dokumentacji rozszerzalności i zaawansowanych funkcjach MCP.

Ocena MCP