서버는 MCP 프로토콜을 사용하여 LLM 애플리케이션과 로컬 Home Assistant 인스턴스에 대한 접근 권한을 공유합니다.

Home Assistant 인스턴스와 언어 학습 모델(LLM) 간의 강력한 다리로, 모델 컨텍스트 프로토콜(MCP)을 통해 스마트 홈 기기의 자연어 제어 및 모니터링을 가능하게 합니다. 이 서버는 장치 제어부터 시스템 관리까지 전체 Home Assistant 생태계를 관리할 수 있는 포괄적인 API를 제공합니다.

특징

• 🎮 장치 제어: 자연어를 통해 모든 Home Assistant 장치를 제어할 수 있습니다
• 🔄 실시간 업데이트: 서버 전송 이벤트(SSE)를 통해 즉시 업데이트를 받음
• 🤖 자동화 관리: 자동화 생성, 업데이트 및 관리
• 📊 상태 모니터링: 장치 상태 추적 및 조회
• 🔐 Secure: 토큰 기반 인증 및 속도 제한
• 📱 모바일 레디: HTTP가 지원되는 모든 클라이언트에서 작동합니다

SSE와의 실시간 업데이트

서버에는 Home Assistant 인스턴스에서 실시간 업데이트를 제공하는 강력한 서버-전송 이벤트(SSE) 시스템이 포함되어 있습니다. 이를 통해 다음과 같은 기능이 가능합니다:

• 🔄 모든 장치에 대해 즉각적인 상태 변경
• 📡 자동화 트리거 및 실행 모니터링

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