AI导哈

飞利浦Hue灯控服务器

一个通过AI助手（如Claude）控制飞利浦Hue灯光的MCP服务器。

  • by redaphid
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 redaphid/philips-hue-mcp

使用说明

飞利浦Hue MCP服务器

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

环境变量

变量 必填 描述
HUE_BRIDGE_IP 是 飞利浦秀桥接器的IP地址
HUE_USERNAME 是 用于身份验证的API令牌/用户名
PORT 无 服务器端口（默认值：3100）

获取凭据

  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 -设置工具

相关 MCP