Сервер использует протокол MCP для совместного доступа к локальному экземпляру Home Assistant с LLM-приложением.

Мощный мост между вашим инстансом Home Assistant и моделями изучения языков (LLM), позволяющий управлять и мониторить ваши умные устройства на естественном языке через протокол Model Context Protocol (MCP). Этот сервер предоставляет комплексный API для управления всей вашей экосистемой Home Assistant — от управления устройствами до системного администрирования.

Особенности

• 🎮 Управление устройством: управление любым устройством Home Assistant с помощью естественного языка
• 🔄 Обновления в реальном времени: Получайте мгновенные обновления через события, отправленные сервером (SSE)
• 🤖 Управление автоматизацией: Создание, обновление и управление автоматизациями
• 📊 Мониторинг состояния: Отслеживание и запрос состояний устройств
• 🔐 Secure: Аутентификация на основе токенов и ограничение скорости
• 📱 Mobile Ready: Работает с любым клиентом с поддержкой HTTP

Обновления в реальном времени с SSE

Сервер включает мощную систему Server-Sent Events (SSE), которая предоставляет обновления в реальном времени с вашего инстанса Home Assistant. Это позволяет вам:

• 🔄 Мгновенное изменение состояния для любого устройства
• 📡 Мониторинг триггеров и выполнения автоматизации

Model Context Protocol Server for Home Assistant

The server uses the MCP protocol to share access to a local Home Assistant instance with an LLM application.

A powerful bridge between your Home Assistant instance and Language Learning Models (LLMs), enabling natural language control and monitoring of your smart home devices through the Model Context Protocol (MCP). This server provides a comprehensive API for managing your entire Home Assistant ecosystem, from device control to system administration.

Features

• 🎮 Device Control: Control any Home Assistant device through natural language
• 🔄 Real-time Updates: Get instant updates through Server-Sent Events (SSE)
• 🤖 Automation Management: Create, update, and manage automations
• 📊 State Monitoring: Track and query device states
• 🔐 Secure: Token-based authentication and rate limiting
• 📱 Mobile Ready: Works with any HTTP-capable client

Real-time Updates with SSE

The server includes a powerful Server-Sent Events (SSE) system that provides real-time updates from your Home Assistant instance. This allows you to:

• 🔄 Get instant state changes for any device
• 📡 Monitor automation triggers and executions
• 🎯 Subscribe to specific domains or entities
• 📊 Track service calls and script executions

Quick SSE Example

const eventSource = new EventSource(
  'http://localhost:3000/subscribe_events?token=YOUR_TOKEN&domain=light'
);

eventSource.onmessage = (event) => {
  const data = JSON.parse(event.data);
  console.log('Update received:', data);
};

See SSE_API.md for complete documentation of the SSE system.

Table of Contents

• Key Features
• Prerequisites
• Installation
  • Basic Setup
  • Docker Setup (Recommended)
• Configuration
• Development
• API Reference
  • Device Control
  • Add-on Management
  • Package Management
  • Automation Management
• Natural Language Integration
• Troubleshooting
• Project Status
• Contributing
• Resources
• License

Key Features

Core Functionality 🎮

• Smart Device Control
  • 💡 Lights: Brightness, color temperature, RGB color