Philips Hue MCP

飞利浦Hue MCP服务器

MCP（模型上下文协议）服务器，用于通过Claude等人工智能助手控制飞利浦秀灯。

环境变量

获取凭据

1. 使用查找网桥IP discover_bridges 工具或检查路由器
2. 按下Hue桥接器顶部的按钮
3. 在30秒内，使用 create_auth_token 工具
4. 保存返回的用户名

码头工人

从GitHub容器注册表中提取

docker pull ghcr.io/redaphid/philips-hue-mcp:latest

跑

docker run -d \
  --name philips-hue-mcp \
  --network host \
  -e HUE_BRIDGE_IP=10.0.2.3 \
  -e HUE_USERNAME=your-token-here \
  ghcr.io/redaphid/philips-hue-mcp:latest

注： --network host 是必需的，以便容器可以到达本地网络上的Hue网桥。

Docker Compose

services:
  philips-hue-mcp:
    image: ghcr.io/redaphid/philips-hue-mcp:latest
    network_mode: host
    environment:
      - HUE_BRIDGE_IP=10.0.2.3
      - HUE_USERNAME=your-token-here
    restart: unless-stopped

本地开发

# Install dependencies
npm install

# Create .env file
echo "HUE_BRIDGE_IP=10.0.2.3" >> .env
echo "HUE_USERNAME=your-token" >> .env

# Run with watch mode
npm run dev

MCP客户端配置

添加到您的 .mcp.json:

{
  "mcpServers": {
    "philips-hue": {
      "type": "http",
      "url": "http://localhost:3100/mcp"
    }
  }
}

可用工具

• list_lights / get_light -查询灯光状态
• turn_light_on / turn_light_off -控制单个灯
• set_light_brightness / set_light_color / set_light_color_temp -调整灯光属性
• list_rooms / turn_room_on / turn_room_off -房间控制
• list_scenes / activate_scene -场景管理
• turn_all_lights_on / turn_all_lights_off -全球控制
• discover_bridges / create_auth_token / test_connection -设置工具