필립스 휴 MCP 서버

Philips Hue 스마트 조명 시스템을 제어하기 위한 강력한 모델 컨텍스트 프로토콜(MCP) 인터페이스입니다.

개요

이 서버는 모델 컨텍스트 프로토콜(MCP)을 활용하여 Claude와 같은 AI 비서와 Philips Hue 조명 시스템 간의 원활한 통합을 제공합니다. 이를 통해 자연어로 스마트 조명을 제어하고, 자세한 조명 정보를 확인하고, 표준화된 AI 친화적 인터페이스를 통해 고급 조명 설정을 생성할 수 있습니다.

특징

완벽한 조명 제어 : 켜기/끄기, 밝기 조절, 색상 변경, 색온도 설정
종합적인 그룹 관리 : 여러 조명을 함께 제어하고 사용자 정의 그룹을 만듭니다.
장면 처리 : 기존 장면 적용, 빠른 사용자 정의 조명 장면 생성
활동 기반 사전 설정 : 독서, 휴식, 집중 등을 위한 미리 설정된 설정
특수 효과 : 컬러 루프와 같은 동적 조명 효과에 액세스하세요
자연어 제어 : 대화를 통한 조명 제어를 위한 특수 프롬프트
안전한 로컬 통합 : 로컬 네트워크의 Hue 브리지에 직접 연결

빠른 시작

지엑스피1

Claude에서 이렇게 시작하세요. "Philips Hue 조명을 제어하고 싶습니다. 사용 가능한 조명을 보여 주시겠습니까?"

설정

필수 조건

파이썬 3.9 이상
로컬 네트워크의 Philips Hue 브리지
브리지와 페어링된 Philips Hue 조명

설치

이 저장소를 복제하거나 hue_server.py 파일을 다운로드하세요.
필요한 종속성을 설치하세요:

pip install phue mcp

첫 번째 실행

서버를 실행합니다:

python hue_server.py

메시지가 표시되면 Hue 브릿지의 링크 버튼을 눌러 연결을 승인합니다.
연결 세부 정보는 향후 사용을 위해 ~/.hue-mcp/config.json 에 저장됩니다.

Claude와 함께 사용

옵션 1: Claude Desktop에 설치

Claude Desktop이 설치된 경우:

mcp install hue_server.py --name "Philips Hue Controller"

옵션 2: MCP 검사기로 테스트

개발 및 테스트를 위해:

mcp dev hue_server.py

API 참조

자원

의지	설명
`hue://lights`	모든 조명에 대한 정보
`hue://lights/{light_id}`	특정 조명에 대한 자세한 정보
`hue://groups`	모든 조명 그룹에 대한 정보
`hue://groups/{group_id}`	특정 그룹에 대한 정보
`hue://scenes`	모든 장면에 대한 정보

도구

도구	설명
`get_all_lights`	모든 조명에 대한 정보를 얻으세요
`get_light`	특정 조명에 대한 자세한 정보를 얻으세요
`get_all_groups`	모든 조명 그룹에 대한 정보를 얻으세요
`get_group`	특정 그룹에 대한 정보를 얻으세요
`get_all_scenes`	모든 장면에 대한 정보를 얻으세요
`turn_on_light`	특정 조명을 켜다
`turn_off_light`	특정 조명을 끄세요
`set_brightness`	조명 밝기 조절 (0-254)
`set_color_rgb`	RGB 값을 사용하여 조명 색상 설정
`set_color_temperature`	조명 색온도 설정(2000-6500K)
`turn_on_group`	그룹의 모든 조명을 켜세요
`turn_off_group`	그룹의 모든 조명을 끕니다
`set_group_brightness`	그룹 밝기 조정(0-254)
`set_group_color_rgb`	그룹의 모든 조명에 대한 색상 설정
`set_scene`	그룹에 장면 적용
`find_light_by_name`	이름으로 조명 검색
`create_group`	새로운 조명 그룹 만들기
`quick_scene`	사용자 정의 설정을 적용하여 장면을 만듭니다.
`refresh_lights`	가벼운 정보 캐시 업데이트
`set_color_preset`	조명에 색상 사전 설정 적용
`set_group_color_preset`	그룹에 색상 사전 설정 적용
`alert_light`	잠깐 빛을 깜빡이세요
`set_light_effect`	색상 루프와 같은 동적 효과 설정

프롬프트

즉각적인	설명
`control_lights`	자연어 조명 제어
`create_mood`	활동을 위한 분위기 조명 설정
`light_schedule`	일정 옵션에 대해 알아보세요

예시

단일 조명 제어

# Turn on a light
turn_on_light(1)

# Set a light to 50% brightness
set_brightness(1, 127)

# Change a light color to purple
set_color_rgb(1, 128, 0, 128)

# Set reading mode
set_color_preset(1, "reading")

그룹 작업

# Turn off all lights in living room (group 2)
turn_off_group(2)

# Create a new group
create_group("Bedroom", [3, 4, 5])

# Set all kitchen lights to energizing mode
set_group_color_preset(3, "energize")

장면 만들기

# Apply an existing scene
set_scene(2, "abc123")  # Group 2, scene ID abc123

# Create a quick relaxing scene for the living room
quick_scene("Evening Relaxation", group_id=2, rgb=[255, 147, 41], brightness=120)

고급 옵션

사용자 지정 설정으로 서버를 실행합니다.

python hue_server.py --host 0.0.0.0 --port 8888 --log-level debug

문제 해결

브리지를 찾을 수 없음 : 자동 검색이 작동하지 않으면 두 가지 옵션이 있습니다.
1. 스크립트에서 BRIDGE_IP 변수를 브리지의 IP 주소로 수동으로 편집합니다.
2. 수동으로 구성 파일을 만듭니다.
  # Create the config directory mkdir -p ~/.hue-mcp # Create a config.json file with your bridge IP echo '{"bridge_ip": "192.168.1.x"}' > ~/.hue-mcp/config.json
  "192.168.1.x"를 실제 Hue 브릿지 IP 주소로 바꾸세요.
연결 문제 : ~/.hue-mcp/config.json 삭제하고 서버를 다시 시작하여 다시 인증하세요.
조명 제어가 작동하지 않음 : refresh_lights 도구를 사용하여 조명 정보 캐시를 업데이트하세요.
그룹 또는 장면이 표시되지 않음 : 모든 데이터를 동기화하려면 브리지와 서버를 다시 시작하세요.

작동 원리

이 서버는 phue Python 라이브러리를 사용하여 Philips Hue 브리지에 연결하고 모델 컨텍스트 프로토콜을 통해 기능을 제공합니다. Claude와 같은 AI가 연결되면:

서버는 저장된 자격 증명을 사용하여 브리지에 인증합니다.
조명 설정을 설명하는 리소스를 제공합니다.
Claude가 조명을 제어하는 데 사용할 수 있는 도구를 공개합니다.
Claude가 조명과 상호 작용하는 방법을 이해하는 데 도움이 되는 프롬프트를 제공합니다.

Hue 시스템과의 모든 통신은 보안과 개인정보 보호를 위해 네트워크 내에서 로컬로 이루어집니다.

기여하다

여러분의 참여를 환영합니다! 자유롭게 참여해 주세요:

이슈 추적기에서 버그를 보고하고 기능을 제안하세요
개선 사항을 포함한 풀 리퀘스트 제출
스마트 홈 설정에서 이것을 사용하는 방법에 대한 예를 공유하세요.

특허

이 프로젝트는 MIT 라이선스에 따라 제공됩니다.

Philips Hue MCP Server

Integrations