Hue Lights

🚀 飛利浦Hue MCP服務器

飛利浦Hue MCP服務器是一款用於控制和管理飛利浦Hue智能燈泡的工具。它藉助MCP協議與飛利浦Hue橋接器通信，讓人工智能（如Claude）能通過自然語言處理來控制燈光，為智能照明控制帶來了極大的便利。

🚀 快速開始

飛利浦Hue MCP（模型上下文協議）服務器可用於控制和管理飛利浦Hue智能燈泡。它通過MCP協議與飛利浦Hue橋接器通信，允許人工智能（如Claude）通過自然語言處理來控制燈光。

✨ 主要特性

• 資源提供：定義設備、燈具、組和場景等資源。
• 工具暴露：提供多種操作工具，如開關燈、調節亮度、更改顏色、設置情景模式等。
• 提示交互：內置提示語幫助AI理解如何與燈光系統互動。

💻 使用示例

基礎用法

控制單個燈具

# 打開一個燈具
turn_on_light(1)

# 調節亮度到50%
set_brightness(1, 127)

# 設置顏色為紫色
set_color_rgb(1, 128, 0, 128)

# 應用閱讀模式
set_color_preset(1, "reading")

控制組

# 關閉客廳燈具組（組ID=2）
turn_off_group(2)

# 創建新組
create_group("臥室", [3, 4, 5])

# 設置廚房燈具為活力模式
set_group_color_preset(3, "energize")

創建情景模式

# 應用已配置的情景模式
set_scene(2, "abc123")  # 組ID=2，情景模式ID=abc123

# 創建快速放鬆情景模式
quick_scene("夜晚放鬆", group_id=2, rgb=[255, 147, 41], brightness=120)

🔧 技術細節

高級選項

通過命令行參數自定義服務器配置：

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

• --host：指定服務器綁定的IP地址（默認為本地IP）
• --port：指定服務器監聽的端口（默認為8090）
• --log-level：設置日誌級別（debug、info、warning等）

如何工作

1. 認證連接：使用飛利浦Hue協議與橋接器建立安全連接。
2. 資源提供：定義燈具、組和情景模式等資源供AI調用。
3. 工具交互：通過MCP協議暴露控制工具，使AI能夠執行燈光操作。
4. 自然語言處理：內置提示語幫助AI理解用戶的意圖並轉換為具體的操作指令。

🛠️ 故障排除

1. 橋接器未發現：

   • 手動編輯配置文件，將BRIDGE_IP變量設為你的Hue橋接器IP地址。
   • 創建一個空白的配置文件並指定橋接器IP：

     mkdir -p ~/.hue-mcp
     echo '{"bridge_ip": "192.168.1.x"}' > ~/.hue-mcp/config.json
     

     其中192.168.1.x替換為你的實際橋接器IP地址。

2. 連接問題：

   • 刪除配置文件並重新啟動服務器以重新認證：

     rm ~/.hue-mcp/config.json
     

3. 燈具控制失效：

   • 使用refresh_lights工具更新燈具信息緩存。

4. 組或情景模式未顯示：

   • 重啟橋接器和服務器以同步數據。

👥 貢獻

歡迎提交問題和建議！

• 倉庫地址：https://github.com/your-repository
• 提交Issue或Pull Request以改進功能。

📄 許可證

本項目遵循MIT許可證：

版權所有 (c) 年份，作者姓名
許可根據 MIT 許可證分發。

允許個人和商業用途。在分發派生作品時，必須保留版權聲明、許可證信息和免責聲明。