/ 디렉터리 / 플레이그라운드 / home-assistant-vibecode-agent
← 모든 서버 ↗ GitHub
● 커뮤니티 Coolver ⚡ 바로 사용

home-assistant-vibecode-agent

제작: Coolver · Coolver/home-assistant-vibecode-agent

IDE에서 홈어시스턴트를 관리하세요. 자동화를 생성하고, 대시보드를 디자인하고, 자연어를 사용하여 구성을 배포하세요.

home-assistant-vibecode-agent는 AI IDE(Claude Code, Cursor, VS Code)가 스마트 홈 구성을 자동으로 관리할 수 있도록 해주는 MCP 서버 통합 기능을 갖춘 홈 어시스턴트 추가 기능입니다. Git 기반 자동 백업과 원클릭 롤백을 통해 자동화 생성, Lovelace 대시보드 설계, HACS 구성 요소 설치, 추가 기능 관리, 구성 검증이 모두 가능합니다.

▶ 데모 보기 📦 설치 💡 사용 사례

왜 쓰나요

핵심 기능

라이브 데모

실제 사용 모습

home-assistant-vibecode-agent-2.replay ▶ 준비됨
0/0

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "home-assistant-vibecode-agent-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/Coolver/home-assistant-vibecode-agent"
      ]
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "home-assistant-vibecode-agent-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/Coolver/home-assistant-vibecode-agent"
      ]
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "home-assistant-vibecode-agent-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/Coolver/home-assistant-vibecode-agent"
      ]
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "home-assistant-vibecode-agent-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/Coolver/home-assistant-vibecode-agent"
      ]
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "home-assistant-vibecode-agent-2",
      "command": "TODO",
      "args": [
        "See README: https://github.com/Coolver/home-assistant-vibecode-agent"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json
{
  "context_servers": {
    "home-assistant-vibecode-agent-2": {
      "command": {
        "path": "TODO",
        "args": [
          "See README: https://github.com/Coolver/home-assistant-vibecode-agent"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add home-assistant-vibecode-agent-2 -- TODO 'See README: https://github.com/Coolver/home-assistant-vibecode-agent'

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: home-assistant-vibecode-agent

자연어로 홈어시스턴트 자동화를 생성하는 방법

👤 YAML을 작성하는 것보다 원하는 것을 설명하는 것을 선호하는 스마트 홈 애호가 ⏱ ~10 min beginner

언제 쓸까: 집에서 무언가를 자동화하고 싶지만 YAML을 수동으로 작성하고 싶지는 않습니다.

사전 조건
  • 애드온이 설치된 홈어시스턴트 — 저장소 https://github.com/coolver/home-assistant-vibecode-agent를 추가하고 설치하세요.
  • MCP 클라이언트가 구성되었습니다. — 추가 기능의 MCP 끝점에 연결하도록 Claude Code 또는 Cursor를 구성하십시오.
흐름
  1. 자동화 설명
    자동화 만들기: 집에 도착하면(휴대폰 GPS가 홈 존에 진입) 거실 조명을 켜고 밝기를 70%로 설정한 다음 주방 스피커에서 Spotify 재생 목록을 재생하기 시작합니다.✓ 복사됨
    → 자동화 YAML 생성 및 검증
  2. 배포 및 테스트
    이 자동화를 배포하고 테스트 실행을 트리거합니다.✓ 복사됨
    → 생성된 백업 및 테스트 결과로 자동화 배포

결과: 일반 영어 설명으로 생성된 작동 중인 홈어시스턴트 자동화입니다.

함정
  • 항목 이름이 설명된 내용과 일치하지 않습니다. — 올바른 이름을 참조할 수 있도록 상담원에게 사용 가능한 엔터티를 먼저 나열하도록 요청하세요.

AI로 맞춤형 Lovelace 대시보드 디자인

👤 Lovelace YAML을 배우지 않고도 더 나은 대시보드를 원하는 홈어시스턴트 사용자 ⏱ ~20 min intermediate

언제 쓸까: 아름답고 기능적인 대시보드를 원하지만 수동 편집기의 한계를 발견했습니다.

사전 조건
  • Vibecode 에이전트가 실행 중이고 연결되어 있음 — 추가 기능 설치 및 MCP 클라이언트 구성
흐름
  1. 대시보드 설명
    내 침실을 위한 대시보드 디자인: 센서의 온도/습도, 밝기 슬라이더를 사용한 조명 제어, Sonos용 미디어 플레이어 카드, 지난 24시간 동안의 온도 그래프를 표시합니다.✓ 복사됨
    → 요청된 모든 카드로 생성된 Lovelace YAML
  2. 디자인 반복
    미디어 플레이어를 상단으로 이동하고 내 침실 색상과 어울리는 어두운 테마를 추가하세요.✓ 복사됨
    → 재정렬된 카드와 맞춤 테마로 업데이트된 대시보드

결과: 홈어시스턴트에 배포된 세련된 Lovelace 대시보드.

함정
  • 맞춤형 카드에는 HACS 설치가 필요합니다 — 맞춤형 카드를 추가하기 전에 상담원에게 필수 HACS 구성 요소를 설치하도록 요청하세요.

조합

다른 MCP와 조합해 10배 효율

home-assistant-vibecode-agent-2 + filesystem

홈어시스턴트 구성을 로컬 파일로 내보내기 및 백업

버전 제어를 위해 모든 자동화 및 대시보드 구성을 ~/ha-backup/으로 내보냅니다.✓ 복사됨

도구

이 MCP가 노출하는 것

도구입력언제 호출비용
create_automation description or YAML 홈어시스턴트 자동화 생성 또는 수정 0
update_dashboard dashboard config Lovelace 대시보드 생성 또는 업데이트 0
list_entities domain?: str 사용 가능한 홈어시스턴트 엔터티 나열 0
call_service domain: str, service: str, data?: obj 홈어시스턴트 서비스 호출(조명 켜기, 미디어 재생 등) 0
install_hacs component: str HACS 커뮤니티 구성 요소 설치 0

비용 및 제한

운영 비용

API 쿼터
N/A — 로컬 홈어시스턴트 인스턴스와 통신합니다.
호출당 토큰
작업당 토큰 200~1000개
금액
무료 — 오픈 소스 추가 기능
팁
자동화를 생성할 때 시행착오를 줄이기 위해 엔터티를 먼저 나열하세요.

보안

권한, 시크릿, 파급범위

최소 스코프: Home Assistant long-lived access token
자격 증명 저장: 추가 기능 설정에 구성된 HA 액세스 토큰
데이터 외부 송신: 로컬 홈어시스턴트 인스턴스하고만 통신합니다. HACS는 GitHub에서 다운로드됩니다.

문제 해결

자주 발생하는 오류와 해결

Add-on can't connect to Home Assistant

장기 액세스 토큰이 올바르고 만료되지 않았는지 확인하세요. 연결 오류가 있는지 추가 기능 로그를 확인하세요.

확인: Check Home Assistant → Settings → Add-ons for the agent's status
Automation validation fails

생성된 YAML은 존재하지 않는 엔터티를 참조할 수 있습니다. 이름을 확인하려면 먼저 엔터티를 나열하세요.

확인: list_entities to see all available entity IDs
HACS component not installing

먼저 HACS 자체가 Home Assistant에 설치되어 있는지 확인하세요. 구성요소 이름이 올바른지 확인하세요.

확인: Verify HACS is accessible from Home Assistant sidebar

대안

home-assistant-vibecode-agent 다른 것과 비교

대안언제 쓰나단점/장점
Home Assistant REST API directlyMCP 계층 없이 직접 API 액세스를 원합니다.더 많은 제어가 가능하지만 AI 지원 YAML 생성 또는 검증이 없음

더 보기

리소스

📖 GitHub에서 공식 README 읽기

🐙 열린 이슈 보기

🔍 400+ MCP 서버 및 Skills 전체 보기