Smart Home Skills

CLI-JAW에서 직접 물리적 환경을 제어하세요. Smart Home 스킬은 AI 어시스턴트와 IoT 기기 사이의 간극을 연결하여, 자연어 명령으로 Philips Hue 조명과 Spotify 재생을 관리할 수 있게 해줍니다.

개요

CLI-JAW에는 인기 있는 기기 생태계에 각각의 API를 통해 연결하는 두 가지 Smart Home 스킬이 기본 탑재되어 있습니다. 두 스킬 모두 MCP(Model Context Protocol) 서버로 구현되어 있으며, 에이전트가 관련 요청을 감지하면 필요 시 로드됩니다.

openhue — Philips Hue 제어

openhue 스킬은 로컬 네트워크에 있는 Philips Hue Bridge와 통신합니다. 개별 조명, 방, 구역, 장면을 제어할 수 있는 MCP 도구를 제공합니다.

기능

설정

CLI-JAW 설정에 openhue MCP 서버를 추가하세요. Bridge IP와 API 키가 필요합니다.

{
  "mcpServers": {
    "openhue": {
      "command": "npx",
      "args": ["-y", "@openhue/mcp-server"],
      "env": {
        "OPENHUE_BRIDGE_IP": "192.168.1.100",
        "OPENHUE_API_KEY": "your-hue-api-key"
      }
    }
  }
}

Hue API 키를 얻으려면 Hue Bridge의 물리적 링크 버튼을 누른 다음 아래 명령을 실행하세요:

curl -X POST http://192.168.1.100/api \
  -d '{"devicetype":"cli-jaw#instance"}'

자연어 예시

동작 원리

"불 켜줘"와 같이 말하면, CLI-JAW는 스킬 매칭 시스템을 통해 요청을 라우팅합니다:

1. 에이전트가 해당 의도를 Smart Home 명령으로 인식합니다
2. openhue MCP 서버가 로드됩니다 (아직 실행 중이 아닌 경우)
3. 에이전트가 적절한 도구를 호출합니다 (예: set_room에 on: true)
4. Hue Bridge가 명령을 실행하고 업데이트된 상태를 반환합니다
5. 에이전트가 자연어로 동작 완료를 확인해 줍니다

spotify-player — Spotify 제어

spotify-player 스킬은 Spotify Web API에 연결하여 CLI-JAW가 음악 재생을 완전히 제어할 수 있게 합니다. 트랙 검색, 대기열 관리, 재생 제어, 플레이리스트 탐색을 지원합니다.

기능

설정

Spotify OAuth 자격 증명과 함께 spotify-player MCP 서버를 추가하세요.

{
  "mcpServers": {
    "spotify-player": {
      "command": "npx",
      "args": ["-y", "spotify-player-mcp"],
      "env": {
        "SPOTIFY_CLIENT_ID": "your-client-id",
        "SPOTIFY_CLIENT_SECRET": "your-client-secret",
        "SPOTIFY_REDIRECT_URI": "http://localhost:8888/callback"
      }
    }
  }
}

OAuth 설정

1. Spotify Developer Dashboard에 접속하세요
2. 리다이렉트 URI를 http://localhost:8888/callback으로 설정하여 새 앱을 만드세요
3. Client ID와 Client Secret을 설정 파일에 복사하세요
4. 처음 사용할 때 CLI-JAW가 Spotify 인증을 위한 브라우저 창을 엽니다
5. 승인 후 리프레시 토큰이 로컬에 캐시되어 이후 세션에서 사용됩니다

자연어 예시

복합 워크플로우

Smart Home 스킬은 서로 결합하거나 다른 CLI-JAW 기능과 함께 사용할 때 더욱 강력해집니다. 에이전트가 맥락을 이해하기 때문에 복합 명령을 자연스럽게 내릴 수 있습니다.

# Example: the agent interprets "영화 볼 준비 해줘" as:
1. openhue → set_room(room="Living Room", brightness=20)
2. openhue → set_scene(scene="Relax", room="Living Room")
3. spotify-player → pause()

문제 해결

환경 변수 참조