Coolver/home-assistant-vibecode-agent

Home Assistant MCP server agent. Enable Claude Code, Cursor, VS Code or any MCP-enabled IDE to help you vibe-code and manage Home Assistant: create and debug automations, design dashboards, tweak themes, modify configs, and deploy changes using natural language

해결하는 문제

Home Assistant를 관리할 때 수동으로 YAML을 편집하거나 깊이 있는 문서 검색이 필요 없어집니다. 사용자는 자연어로 스마트홈 목표를 설명하기만 하면, AI가 그 요구사항을 수동으로 코드를 작성하거나 스니펫을 복사 붙여넣기하지 않고도 기능하는 자동화, 스크립트, 대시보드로 변환합니다.

작동 방식

이 프로젝트는 AI IDE에 안정적인 인터페이스를 제공하는 두 부분으로 구성된 아키텍처를 사용합니다:

Home Assistant 에이전트: Home Assistant 내부 또는 옆에서 실행되는 서비스(애드온 또는 Docker 컨테이너로)로, API, 파일, 런타임 상태에 네이티브로 접근 가능합니다.
Home Assistant MCP 서버: 사용자의 컴퓨터에서 실행되는 모듈로, Model Context Protocol (MCP)를 사용하여 AI IDE(Cursor, Claude Code, VS Code 등)를 안전한 REST API를 통해 에이전트에 연결합니다.

이 설계는 취약한 SSH 기반 스크립팅을 피하고, AI에게 구조화되고 관련성 있는 컨텍스트와 설정을 안전하게 수정할 수 있는 제어된 작업 세트를 제공합니다.

대상 사용자

자동화 워크플로우를 가속화하고 싶은 경험 많은 Home Assistant 사용자, 그리고 복잡한 스마트홈 시스템을 AI로 설계하고 배포하면서도 변경 사항을 검토하고 롤백할 수 있는 능력을 유지하고 싶은 사용자.

주요 기능

자연어 기반 배포: 예를 들어 여러 TRV를 포함한 기후 제어 시스템과 같은 복잡한 시스템을 요구사항을 설명하는 것으로 간단히 생성 가능.
IDE 통합: Cursor, VS Code, Claude Code와 같은 MCP 지원 IDE와 직접 연동.
안전한 수정: 모든 변경 사항에 대해 자동으로 Git 기반 버전 관리가 이루어져 쉽게 롤백 가능.
포괄적인 관리: 엔티티 분석, 헬퍼 생성, UI 대시보드 설계, 테마 조정, HACS 통합 관리가 가능.
네이티브 접근: 외부 SSH 해킹에 의존하지 않고 전용 에이전트를 통해 내부 HA API와 상태에 직접 접근.