Nieoficjalny i niesamowity serwer MCP Home Assistant

angler · 17 Luty 2026 18:11

Obecność AI w Home Assistant to już fakt i nie unikniemy wykorzystywania tego rodzaju narzędzi jak LLM. Jeśli (prawdopodobnie) nie będzie nam dane z AI wygrać, to trzeba je poznać i wykorzystać (do póki się daje).
Powstał niesamowity projekt, który dzięki Model Context Protocol (MCP), pozwala na ścisłe zintegrowanie instancji HA z wybranymi modelami LLM.
Prowadzisz konwersację w naturalnym języku a agent LLM, mając dostęp do wszystkich ustawień, konfiguracji twojego HA, może w locie (przez API HA) zmieniać dosłownie wszystko. Tworzyć automatyzacje, sceny, czy analizować kod YAML każdego z elementów systemu. Szukać błędów, debugować czy wykorzystywać OCR (zrzuty z kamer).

Daje to niezwykłe możliwości ingerencji i ingerencji. W przypadku HA ogranicza nas zawsze tylko wyobraźnia i zasób portfela. Kiedyś dodawałem jeszcze wiedza, ale w tej sytuacji wystarczy ta opanowana w dziedzinie wykorzystywania narzędzi AI i jak zawsze ogólna-techniczna.

Usługa serwera MCP jako AddOn czyli obecnie Aplikacja

github.com

homeassistant-ai/ha-mcp/blob/master/homeassistant-addon/DOCS.md

# Home Assistant MCP Server Add-on

AI assistant integration for Home Assistant via Model Context Protocol (MCP).

## About

This add-on enables AI assistants (Claude, ChatGPT, etc.) to control your Home Assistant installation through the Model Context Protocol (MCP). It provides 80+ tools for device control, automation management, entity search, calendars, todo lists, dashboards, backup/restore, history/statistics, camera snapshots, and system queries.

**Key Features:**
- **Zero Configuration** - Automatically discovers Home Assistant connection
- **Secure by Default** - Auto-generated secret paths with 128-bit entropy
- **Fuzzy Search** - Find entities even with typos
- **Deep Search** - Search within automation triggers, script sequences, and helper configs
- **Backup & Restore** - Safe configuration management

Full features and documentation: https://github.com/homeassistant-ai/ha-mcp

---

## Installation

This file has been truncated. show original

Projekt wręcz eksplodował patrząc, po statystykach:

Allon · 17 Luty 2026 18:35

Jescze dodam:

angler · 17 Luty 2026 19:03

Tu należy podać różnice pomiędzy natywnym serwisem (integracją) MPT w HA, a tym nieoficjalnym kontenerem aplikacji (AddOn), czy też zupełnie zewnętrznie hostowanym serwerem MPT :

Oficjalna integracja MCP Server w HA

To standardowa integracja w Home Assistant: dodajesz ją w „Urzadzenia i usługi” i konfigurujesz z poziomu UI.
Jej główny cel: pozwolić HA korzystać z zewnętrznych serwerów MCP jako narzędzi dla Asystenta (Assist), np. MCP od wyszukiwania w sieci, pamięci, itp.
Kontrola HA przez LLM odbywa się nadal przez Assist API – integracja daje warstwę pośrednią i kontrolę, jakie encje/usługi są wystawione.
Jest częścią ekosystemu HA, z naciskiem na bezpieczeństwo, uprawnienia, integrację z istniejącym Asystentem.

Nieoficjalny ha-mcp (homeassistant-ai/ha-mcp)

To osobny projekt społeczności: „The Unofficial and Awesome Home Assistant MCP Server”.
Uruchamiasz go jako proces / Docker / uv na swojej maszynie i podajesz mu HOMEASSISTANT_URL + HOMEASSISTANT_TOKEN – łączy się z HA po API.
Zaprojektowany głównie pod Claude Desktop, Claude Code, ChatGPT, Gemini, VS Code, Cursor, Open WebUI itd. – ma gotowe skrypty instalacyjne i setup wizard dla wielu klientów.
Oferuje ogromny zestaw narzędzi (82+ tools): pełne zarządzanie automacjami, skryptami, dashboardami, helperami, grupami, strefami, backup/restore, update’y, logbook, historia, ZHA itd. – nie tylko podstawowe on/off.

Kluczowe różnice (tabela)

Cecha	MCP Server (integracja HA)	ha-mcp (homeassistant-ai)
Status	Oficjalna integracja HA	Nieoficjalny projekt społeczności
Gdzie działa	Wewnątrz Home Assistant	Osobny serwer łączący się po API z HA
Główny cel	Używanie zewnętrznych MCP w HA (Assist)	Pełna kontrola HA przez klientów MCP (Claude, ChatGPT itd.)
Instalacja	Dodanie integracji w UI HA	uv / Docker / skrypty, konfiguracja URL + token
Zakres funkcji	Ekspozycja narzędzi MCP do Assist	Bardzo szerokie narzędzia: encje, automacje, dashboardy, backup itd.
Nastawienie	Integracja z Assist, bezpieczeństwo, uprawnienia	UX pod LLM-y, szybki start, wizard dla wielu klientów MCP
Oficjalne wsparcie	Zespół Home Assistant	Społeczność (homeassistant-ai)

Jak to przełożyć na praktykę

Jeśli chcesz, aby Assist w HA używał zewnętrznych MCP (np. serwera od pamięci, web-search) – patrz integracja mcp_server w HA.
Jeśli chcesz, aby Claude / ChatGPT / inny klient MCP mógł ogarniać i konfigurować Twojego Home Assistanta (tworzyć automacje, dashboardy, analizować problemy) – użyj ha-mcp i dodaj go jako MCP server w kliencie AI.

UWAGA! to jest potężne narzędzie, ściślej ich duży zbiór (lista poniżej) i może psuć Twój system jeśli nie wiesz jak go używać.

Lista narzędzi (82+)

Poniższa tabela bazuje na pełnej liście z dokumentacji projektu – narzędzia pozwalają AI na zaawansowane operacje na HA.

Kategoria	Narzędzia
Search & Discovery	`ha_search_entities`, `ha_deep_search`, `ha_get_overview`, `ha_get_state`
Service & Device Control	`ha_call_service`, `ha_bulk_control`, `ha_get_operation_status`, `ha_get_bulk_status`, `ha_list_services`
Automations	`ha_config_get_automation`, `ha_config_set_automation`, `ha_config_remove_automation`
Scripts	`ha_config_get_script`, `ha_config_set_script`, `ha_config_remove_script`
Helper Entities	`ha_config_list_helpers`, `ha_config_set_helper`, `ha_config_remove_helper`
Dashboards	`ha_config_list_dashboards`, `ha_config_get_dashboard`, `ha_config_set_dashboard`, `ha_config_update_dashboard_metadata`, `ha_config_delete_dashboard`, `ha_get_dashboard_guide`, `ha_get_card_types`, `ha_get_card_documentation`
Areas & Floors	`ha_config_list_areas`, `ha_config_set_area`, `ha_config_remove_area`, `ha_config_list_floors`, `ha_config_set_floor`, `ha_config_remove_floor`
Labels	`ha_config_list_labels`, `ha_config_get_label`, `ha_config_set_label`, `ha_config_remove_label`, `ha_assign_label`
Zones	`ha_list_zones`, `ha_create_zone`, `ha_update_zone`, `ha_delete_zone`
Groups	`ha_config_list_groups`, `ha_config_set_group`, `ha_config_remove_group`
Todo Lists	`ha_list_todo_lists`, `ha_get_todo_items`, `ha_add_todo_item`, `ha_update_todo_item`, `ha_remove_todo_item`
Calendar	`ha_config_get_calendar_events`, `ha_config_set_calendar_event`, `ha_config_remove_calendar_event`
Blueprints	`ha_list_blueprints`, `ha_get_blueprint`, `ha_import_blueprint`
Device Registry	`ha_list_devices`, `ha_get_device`, `ha_update_device`, `ha_remove_device`, `ha_rename_entity`
ZHA & Integrations	`ha_get_zha_devices`, `ha_get_entity_integration_source`
Add-ons	`ha_list_addons`, `ha_list_available_addons`
Camera	`ha_get_camera_image`
History & Statistics	`ha_get_history`, `ha_get_statistics`
Automation Traces	`ha_get_automation_traces`
System & Updates	`ha_check_config`, `ha_restart`, `ha_reload_core`, `ha_get_system_info`, `ha_get_system_health`, `ha_list_updates`, `ha_get_release_notes`, `ha_get_system_version`
Backup & Restore	`ha_backup_create`, `ha_backup_restore`
Utility	`ha_get_logbook`, `ha_eval_template`, `ha_get_domain_docs`, `ha_list_integrations`