Home Assistant MCP 서버

“Home Assistant” MCP 서버는 무엇을 하나요?

Home Assistant MCP 서버(hass-mcp)는 모델 컨텍스트 프로토콜(MCP) 서버로, Claude 등 LLM 기반 AI 어시스턴트와 Home Assistant 생태계를 연결합니다. Home Assistant의 데이터와 기능을 MCP 표준을 통해 노출시켜, AI 에이전트가 스마트홈 기기와 자동화를 질의, 제어, 관리할 수 있습니다. hass-mcp로 가능한 일반 작업에는 기기 및 센서 상태 질의, 조명/스위치 토글, 가정 상태 요약, 자동화 문제 진단, 특정 엔티티 검색, 자주 쓰는 스마트홈 활동을 위한 가이드 대화 등이 있습니다. 이 통합은 대화형 AI, 자동화, LLM 기반 에이전트를 통한 스마트홈 관리의 접근성과 개발·사용자 워크플로를 향상시킵니다.

프롬프트 목록

• 저장소에 문서화된 프롬프트 템플릿이 없습니다.

리소스 목록

• 저장소에 명시적인 MCP 리소스가 나와 있지 않습니다.

도구 목록

• 기기 및 센서 상태 질의: LLM이 Home Assistant 엔티티의 현재 상태를 조회할 수 있습니다.
• 조명, 스위치 등 엔티티 제어: 지원되는 스마트홈 구성요소를 직접 제어(온/오프, 밝기 등)할 수 있습니다.
• 스마트홈 요약 조회: 집의 현재 상태에 대한 하이레벨 개요 또는 집계 정보를 제공합니다.
• 자동화 및 엔티티 문제 해결: 자동화나 기기 엔티티의 문제 진단 정보를 제공하거나 해결 단계를 안내합니다.
• 특정 엔티티 검색: Home Assistant 내에서 이름이나 유형으로 기기나 센서를 빠르게 찾을 수 있습니다.
• 일반 작업을 위한 가이드 대화 생성: 자주 쓰는 스마트홈 작업을 단계별로 안내하는 구조화된 상호작용을 지원합니다.

MCP 서버 활용 사례

• 기기 상태 질의: 개발자와 사용자는 프로그래밍 방식 또는 대화형으로 현재 상태(예: “주방 창문이 열려 있나요?”)를 요청하여 모니터링·자동화 논리에 활용할 수 있습니다.
• 스마트홈 제어: 음성 어시스턴트나 챗봇으로 조명을 켜고/끄거나, 온도 조절, 가전 제어가 가능해져 접근성 및 자동화가 강화됩니다.
• 집 상태 보고서: LLM이 일일 또는 필요시 “오늘 저녁 우리집 상태는?” 같은 요약을 생성해 사용자 편의성이나 대시보드 통합에 활용됩니다.
• 자동화 문제 해결: 개발자는 MCP 서버를 활용해 자동화 설정 오류나 실패 원인을 진단하고 디버깅을 간소화할 수 있습니다.
• 엔티티 검색 및 단계별 안내: 특정 기기 빠른 찾기, 또는 복잡한 다단계 루틴(예: “모닝 루틴 설정”)을 안내하여 스마트홈 관리가 쉬워집니다.

설치 방법

Windsurf

1. 시스템에 Python과 Docker가 설치되어 있는지 확인합니다.
2. hass-mcp 저장소를 클론하고 .env 파일(예시는 .env.example 참고)에 Home Assistant 연결 정보를 설정합니다.
3. Windsurf에서 설정 > MCP 서버 섹션을 엽니다.
4. 다음과 같이 JSON 구성으로 hass-mcp 서버를 추가합니다:

   {
     "mcpServers": {
       "hass-mcp": {
         "command": "docker",
         "args": ["run", "--env-file=.env", "-p", "8080:8080", "voska/hass-mcp:latest"]
       }
     }
   }
   

5. 설정을 저장하고 Windsurf를 재시작합니다. MCP 목록에 서버가 표시되는지 확인하세요.

Claude

1. hass-mcp 서버를 로컬 또는 Claude에서 접근 가능한 서버에 배포합니다.
2. 환경 변수를 사용해 Home Assistant API 키를 안전하게 보호하세요.
3. Claude 구성에 MCP 서버 항목을 추가합니다:

   {
     "mcpServers": {
       "hass-mcp": {
         "command": "python",
         "args": ["-m", "app.main"]
       }
     }
   }
   

4. Claude를 재시작하고 MCP 서버 사용 가능 여부를 확인하세요.
5. 환경 변수로 민감한 데이터를 보호하세요(아래 참고).

Cursor

1. hass-mcp를 배포하고, Cursor와 MCP 서버 간 네트워크 접근이 가능한지 확인합니다.
2. Cursor에서 MCP 서버를 사용하도록 구성합니다:

   {
     "mcpServers": {
       "hass-mcp": {
         "command": "python",
         "args": ["-m", "app.main"]
       }
     }
   }
   

3. 구성 저장 후 Cursor를 재시작합니다.
4. 필요시 API 키용 환경 변수를 설정하세요.

Cline

1. 의존성을 설치하고 hass-mcp 서버를 실행합니다(자세한 내용은 저장소 참고).
2. Cline에서 MCP 구성 파일을 엽니다.
3. hass-mcp 서버를 추가합니다:

   {
     "mcpServers": {
       "hass-mcp": {
         "command": "python",
         "args": ["-m", "app.main"]
       }
     }
   }
   

4. Cline을 재시작하여 새 MCP 서버를 활성화합니다.

API 키 보호(모든 플랫폼):

구성에서 환경 변수를 사용해 민감한 정보를 보호하세요:

{
  "mcpServers": {
    "hass-mcp": {
      "env": {
        "HASS_TOKEN": "${HASS_TOKEN}"
      },
      "inputs": {
        "hass_url": "http://your-homeassistant.local:8123"
      }
    }
  }
}

플로우 내에서 MCP 사용법

FlowHunt에서 MCP 사용하기

FlowHunt 워크플로에 MCP 서버를 통합하려면 MCP 컴포넌트를 플로우에 추가하고 AI 에이전트와 연결하세요:

MCP 컴포넌트를 클릭해 구성 패널을 여세요. 시스템 MCP 구성 섹션에 다음과 같은 JSON 형식으로 MCP 서버 정보를 입력합니다:

{
  "hass-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

구성 완료 후 AI 에이전트는 MCP의 모든 기능과 역량에 접근할 수 있습니다. “hass-mcp"를 실제 MCP 서버 이름으로, URL을 본인의 MCP 서버 주소로 바꿔주세요.

개요

공개 문서와 저장소 내용을 바탕으로 hass-mcp는 MCP를 통한 Home Assistant 통합에 견고한 기반(명확한 도구 지원, 합리적 설치/보안 방식)을 제공합니다. 다만, 명확한 프롬프트 템플릿, 리소스 정의, 고급 샘플링/roots 기능 등은 문서에서 부족합니다. 이 MCP 서버는 6/10점: 실용적이고 개발자 친화적이지만, 확장성 문서와 고급 MCP 기능이 부족합니다.

MCP 점수