Hubitat MCP 서버 구축하기

요즘 Home Assistant도 그렇고 SmartThings도 그렇고 MCP 서버 구축 가이드가 많아지고 있다.

나도 Hubitat에서 저런거 있었으면 좋겠다는 생각에 커뮤니티를 검색해봤는데 괜찮은 가이드가 있어서 구축해봤다.

일단 찾은 MCP 서버는 아래 링크이다.

https://github.com/kingpanther13/Hubitat-local-MCP-server

GitHub - kingpanther13/Hubitat-local-MCP-server

 

Hubitat hub와 Claude code CLI를 설치할 홈서버, Claud 계정만 있으면 준비가 다 된다.

 

MCP Rule Server 설치

먼저 Hubitat의 HPM에서 MCP를 검색해서 app를 설치하자.

MCP를 검색하면 MCP Rule Server가 하나 검색이 된다.

 

설치가 다 된후 +Add user app으로 app을 추가하자.

 

추가된 MCP Rule Server를 실행해보자.

여기서 Local Endpoint와 CloudEndpoint 주소를 적어놓자.

그리고 Select Devices for MCP Access는 MCP 서버가 접근할 수 있는 장치들을 선택해주면 된다.

난 왠만한 장치들을 모두 추가했다.

 

Claude Code CLI 설치

이제 홈서버로 가자.

홈서버에서 아래 명령어를 이용해서 Claude Code CLI를 설치하자.

curl -fsSL https://claude.ai/install.sh | bash

 

아래 명령어를 이용해서 .mcp.json 파일을 만들고 아까 저장해둔 Hubitat의 local Endpoint 주소를 적어주자.

cd ~/

vi .mcp.json

{
  "mcpServers": {
    "hubitat": {
      "type": "url",
      "url": "http://192.168.x.x/apps/api/123/mcp?access_token=YOUR_TOKEN"
    }
  }
}

 

이제 로컬에서 해야할 일은 끝났다.

다음은 Claude에 접속해서 MCP Server를 등록해주자.

 

Claude에서 MCP 서버 등록

웹브라우저에서 https://claude.ai/ 에 접속하자.

아래 순서로대 실행해서 커스텀 커넥터를 추가하자.

설정 → 커넥터 → 커스텀 커넥터 추가

 

커스텀 커넥터 추가시 저장해뒀던 Hubitat의 Cloud Endpoint 정보를 입력하자.

 

Hubitat MCP가 추가되었다. 옆의 구성을 눌러보자.

 

나는 항상 허용을 해주었다. 

 

이제 Agent skill을 추가해보자.

먼저 Github에서 agent-skill/hunitat-mcp를 다운로드하자.

다운로드하기 귀찮다면 아래 zip 파일을 다운로드해도 된다.

hubitat-mcp.zip

0.01MB

 

다운로드 후 해당 디렉토리를 zip 파일로 압축하자.

 

다시 claude 웹으로 돌아와서 설정 → 기능 → 스킬 로 이동하자.

 

상단 +를 눌러서 스킬 만들기 → 스킬 업로드 → 팝업창에서 위에서 만든 zip 파일 업로드

 

업로드 완료된 agent-skill

 

이제 Claude에서 채팅으로 이것저것 물어보면 답변을 해준다.

다만 나는 무료 버전을 사용하고 있어서 이것저것 물어보니까 일일 제한량이 금방 도달해버렸다. ㅠㅠ

결제하고 싶은 욕구가 마구 생긴다.