サーバーはMCPプロトコルを使用して、LLMアプリケーションとローカルのHome Assistantインスタンスへのアクセスを共有します。

Home Assistantインスタンスと言語学習モデル(LLM)をつなぐ強力な橋渡しであり、Model Context Protocol(MCP)を通じてスマートホームデバイスの自然言語制御と監視を可能にします。このサーバーは、デバイス制御からシステム管理まで、Home Assistantエコシステム全体を管理するための包括的なAPIを提供します。

特徴

• 🎮 デバイス制御:自然言語を通じて任意のホームアシスタントデバイスを制御
• 🔄 リアルタイム更新:サーバー送信イベント(SSE)による即時更新
• 🤖 自動化管理:自動化の作成、更新、管理
• 📊 状態監視:デバイスの状態を追跡・照会
• 🔐 Secure:トークンベースの認証およびレート制限
• 📱 Mobile Ready:HTTP対応クライアントで動作

SSEとのリアルタイムアップデート

サーバーには強力なサーバー送信イベント(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