Skip to main content
Glama
OpenHue MCP Server

OpenHue MCP Server

by lsemenenko

OpenHue MCP 서버

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

필수 조건

Related MCP server: Philips Hue MCP Service

브리지 설정

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

  1. 설치 명령을 실행합니다.

지엑스피1

  1. 화면의 지침을 따르세요.

    • CLI는 Hue Bridge를 검색합니다.

    • 메시지가 표시되면 Hue Bridge의 링크 버튼을 누르세요.

    • 설정이 완료되었는지 확인할 때까지 기다리세요.

  2. 조명을 나열하여 설정을 확인하세요.

# 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 서버를 사용할 준비가 된 것입니다.

설치

  1. 저장소를 복제합니다.

git clone <your-repo-url>
cd claude-mcp-openhue
  1. 종속성 설치:

npm install
  1. 프로젝트를 빌드하세요:

npm run build
  1. 서버를 실행합니다:

npm start

특징

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

조명 제어

  • 모든 조명을 나열하거나 특정 조명 세부 정보를 얻으세요

  • 불 켜기/끄기

  • 밝기 조절

  • 색상 설정

  • 색온도 조절

룸 컨트롤

  • 모든 객실을 나열하거나 객실 세부 정보를 얻으세요

  • 방의 모든 조명을 함께 제어하세요

  • 방 전체의 밝기와 색상 설정

장면 관리

  • 사용 가능한 장면 나열

  • 다양한 모드로 장면 활성화

  • 방별로 장면 필터링

Claude Desktop과 함께 사용

  1. Claude Desktop 구성 파일을 엽니다.

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

    • Windows: %APPDATA%\Claude\claude_desktop_config.json

  2. 서버 구성을 추가합니다.

{
  "mcpServers": {
    "hue": {
      "command": "node",
      "args": ["/absolute/path/to/build/index.js"]
    }
  }
}
  1. Claude Desktop을 다시 시작하세요

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

예제 명령

연결되면 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

문제 해결

서버가 연결되지 않음

  1. Docker가 실행 중인지 확인하세요

  2. OpenHue 구성이 있는지 확인하세요

  3. Claude Desktop 로그 확인

  4. OpenHue CLI를 직접 실행해보세요

명령 실패

  1. OpenHue CLI 권한 확인

  2. 조명/방/장면 이름 확인

  3. Docker 컨테이너 로그 확인

  4. Hue Bridge 연결 확인

특허

MIT 라이센스

기여하다

  1. 저장소를 포크하세요

  2. 기능 브랜치를 생성하세요

  3. 변경 사항을 커밋하세요

  4. 지점으로 밀어 넣기

  5. 새로운 풀 리퀘스트 만들기

Available Tools

6 tools
activate-sceneC

Activate a specific scene

Inputs: name (required), mode, room.

control-lightC

Control a specific Hue light

Inputs: action (required), target (required), brightness, color, +1 more.

control-roomC

Control all lights in a room

Inputs: action (required), target (required), brightness, color, +1 more.

get-lightsB

List all Hue lights or get details for a specific light

Inputs: lightId, room.

get-roomsB

List all rooms or get details for a specific room

Inputs: roomId.

get-scenesC

List all scenes or get details for specific scenes

Inputs: room.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: activate-scene targets scene activation, control-light and control-room handle light control at different granularities, and the get-* tools retrieve specific resource types. There is no overlap in functionality, making tool selection straightforward for an agent.

    Naming Consistency5/5

    All tool names follow a consistent verb-noun pattern with hyphen separation (e.g., activate-scene, control-light, get-lights). The naming is uniform across all tools, with no deviations in style or convention, ensuring predictability and readability.

    Tool Count5/5

    With 6 tools, the server is well-scoped for managing Philips Hue devices. The count is appropriate, covering core operations like control and retrieval for lights, rooms, and scenes without being overly sparse or bloated, fitting typical home automation workflows.

    Completeness4/5

    The toolset provides solid coverage for the Hue domain, including control and retrieval for lights, rooms, and scenes. A minor gap exists in missing update or delete operations for scenes or rooms, but agents can still accomplish most common tasks with the available tools.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      A
      quality
      D
      maintenance
      Enables control of Philips Hue lights through VS Code Copilot or Claude Desktop using natural language commands. Supports turning lights on/off, adjusting brightness, changing colors, and listing available lights on your Hue Bridge.
      2
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables control of Philips Hue lights through the Model Context Protocol, providing tools for turning lights on/off, setting brightness and color, and retrieving light status.
      1
      Apache 2.0
    • F
      license
      Not graded
      quality
      D
      maintenance
      Controls Philips Hue lights based on Claude Code session events, using color animations to indicate Claude's status (thinking, working, success, etc.).
      10
      -