local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Provides comprehensive control of Philips Hue lighting systems through the OpenHue CLI, including turning lights on/off, adjusting brightness, setting colors, controlling color temperature, managing rooms, and activating scenes.

OpenHue MCP 서버

OpenHue CLI를 사용하여 Claude 및 기타 LLM 인터페이스를 통해 Philips Hue 조명을 제어할 수 있는 MCP 서버입니다.

필수 조건

Node.js (v16 이상)
도커
데스크톱용 Claude (선택 사항, 테스트용)

브리지 설정

서버를 사용하기 전에 Hue Bridge로 OpenHue CLI를 설정해야 합니다.

설치 명령을 실행합니다.

지엑스피1

화면의 지침을 따르세요.
- CLI는 Hue Bridge를 검색합니다.
- 메시지가 표시되면 Hue Bridge의 링크 버튼을 누르세요.
- 설정이 완료되었는지 확인할 때까지 기다리세요.
조명을 나열하여 설정을 확인하세요.

# On Linux/macOS:
docker run -v "${HOME}/.openhue:/.openhue" --rm --name=openhue -it openhue/cli get lights

# On Windows (PowerShell):
docker run -v "${env:USERPROFILE}\.openhue:/.openhue" --rm --name=openhue -it openhue/cli get lights

조명이 나열되어 있으면 설정이 완료되고 MCP 서버를 사용할 준비가 된 것입니다.

설치

저장소를 복제합니다.

git clone <your-repo-url>
cd claude-mcp-openhue

종속성 설치:

npm install

프로젝트를 빌드하세요:

npm run build

서버를 실행합니다:

npm start

특징

이 서버는 MCP를 통해 다음과 같은 기능을 제공합니다.

조명 제어

모든 조명을 나열하거나 특정 조명 세부 정보를 얻으세요
불 켜기/끄기
밝기 조절
색상 설정
색온도 조절

룸 컨트롤

모든 객실을 나열하거나 객실 세부 정보를 얻으세요
방의 모든 조명을 함께 제어하세요
방 전체의 밝기와 색상 설정

장면 관리

사용 가능한 장면 나열
다양한 모드로 장면 활성화
방별로 장면 필터링

Claude Desktop과 함께 사용

Claude Desktop 구성 파일을 엽니다.
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
서버 구성을 추가합니다.

{
  "mcpServers": {
    "hue": {
      "command": "node",
      "args": ["/absolute/path/to/build/index.js"]
    }
  }
}

Claude Desktop을 다시 시작하세요
서버가 연결되었는지 확인하려면 망치 아이콘을 찾으세요.

예제 명령

연결되면 Claude에게 다음과 같은 자연어 질문을 할 수 있습니다.

"거실에는 어떤 조명이 있나요?"
"주방의 모든 불을 켜세요"
"침실 조명을 50% 밝기로 설정해"
"사무실 조명을 파란색으로 바꿔주세요"
"휴식" 장면을 활성화하세요
"굴에는 어떤 장면이 있나요?"

사용 가능한 도구

겟라이트

모든 조명을 나열하거나 특정 조명에 대한 세부 정보를 가져옵니다.

{
  lightId?: string;  // Optional light ID or name
  room?: string;     // Optional room name filter
}

제어등

개별 조명을 제어합니다

{
  target: string;    // Light ID or name
  action: "on" | "off";
  brightness?: number; // 0-100
  color?: string;     // Color name
  temperature?: number; // 153-500 Mirek
}

방을 얻으세요

모든 객실을 나열하거나 특정 객실 세부 정보를 가져옵니다.

{
  roomId?: string;  // Optional room ID or name
}

통제실

방의 모든 조명을 제어합니다

{
  target: string;    // Room ID or name
  action: "on" | "off";
  brightness?: number;
  color?: string;
  temperature?: number;
}

장면 가져오기

사용 가능한 장면을 나열합니다

{
  room?: string;    // Optional room name filter
}

활성화 장면

특정 장면을 활성화합니다

{
  name: string;     // Scene name or ID
  room?: string;    // Optional room name
  mode?: "active" | "dynamic" | "static";
}

개발

프로젝트 구조

.
├── src/
│   └── index.ts    # Main server implementation
├── build/          # Compiled JavaScript
├── package.json
├── tsconfig.json
└── README.md

건물

npm run build

달리기

npm start

문제 해결

서버가 연결되지 않음

Docker가 실행 중인지 확인하세요
OpenHue 구성이 있는지 확인하세요
Claude Desktop 로그 확인
OpenHue CLI를 직접 실행해보세요

명령 실패

OpenHue CLI 권한 확인
조명/방/장면 이름 확인
Docker 컨테이너 로그 확인
Hue Bridge 연결 확인

특허

MIT 라이센스

기여하다

저장소를 포크하세요
기능 브랜치를 생성하세요
변경 사항을 커밋하세요
지점으로 밀어 넣기
새로운 풀 리퀘스트 만들기

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

OpenHue CLI를 사용하여 Claude 및 기타 LLM 인터페이스를 통해 Philips Hue 조명을 제어할 수 있습니다.

OpenHue MCP Server