hass-mcp

Home Assistant를 제어하고 쿼리하기 위한 오픈 소스 MCP 서버입니다.

• 전송: stdio

• 인증: Home Assistant 장기 토큰(long-lived token)

• API: Home Assistant REST API

기능

제공되는 도구:

• ha_get_state — 엔티티의 상태 가져오기

• ha_list_states — 모든 상태 나열 (데이터가 많을 수 있음)

• ha_call_service — 서비스 호출

설치

pnpm install
pnpm build

실행

export HASS_URL="http://homeassistant.local:8123"
export HASS_TOKEN="<your long-lived access token>"

pnpm start

MCP 클라이언트 설정

예시 (개념적):

{
  "mcpServers": {
    "homeassistant": {
      "command": "npx",
      "args": ["-y", "hass-mcp"],
      "env": {
        "HASS_URL": "http://homeassistant.local:8123",
        "HASS_TOKEN": "..."
      }
    }
  }
}

보안

• 토큰을 비밀로 취급하십시오.

• 이 서버를 Home Assistant와 동일한 LAN에서 실행하는 것을 권장합니다.

• HA가 Cloudflare Access 뒤에 있는 경우, 이 MCP 서버를 LAN 측에서 실행하십시오.

라이선스

MIT