MCP Philips Hue

🚀 mcp-philips-hue

這是一個用於控制飛利浦Hue智能燈的MCP（模型上下文協議）服務器，可幫助你輕鬆管理和控制飛利浦Hue智能燈的各項功能。

🚀 快速開始

本項目是一個用於控制飛利浦Hue智能燈的MCP服務器。要使用該服務器，你需要完成以下幾個步驟：獲取Hue API密鑰、安裝項目、進行配置，之後就可以使用提供的命令來控制燈光了。

✨ 主要特性

• get_lights - 列出所有連接到你的Hue橋接器的燈光。
• set_brightness - 為單個或所有燈光調整亮度（範圍0 - 254）。
• set_color - 使用十六進制代碼、顏色名稱或色溫來改變燈光顏色。
• toggle_light - 打開或關閉燈光。

📦 安裝指南

從npm安裝（推薦）

npx mcp-philips-hue

從源代碼安裝

git clone https://github.com/m2ai-mcp-servers/mcp-philips-hue.git
cd mcp-philips-hue
npm install
npm run build

📚 詳細文檔

獲取Hue API密鑰

1. 在https://discovery.meethue.com/ 找到你的橋接器IP地址。
2. 訪問 http://<橋接器IP>/debug/clip.html。
3. 按下你的Hue橋接器上的鏈接按鈕。
4. 在30秒內，向 /api 發送POST請求，請求體為：{"devicetype":"mcp-server#user"}。
5. 從響應中複製 username，這就是你的API密鑰。

配置

環境變量

export HUE_BRIDGE_IP=192.168.1.x
export HUE_API_KEY=your-api-key-here

Claude桌面配置

在你的 claude_desktop_config.json 中添加以下內容：

{
  "mcpServers": {
    "philips-hue": {
      "command": "npx",
      "args": ["-y", "mcp-philips-hue"],
      "env": {
        "HUE_BRIDGE_IP": "192.168.1.x",
        "HUE_API_KEY": "your-api-key-here"
      }
    }
  }
}

顏色選項

命名顏色

紅色、綠色、藍色、黃色、橙色、紫色、粉色、白色、青色、品紅色

色溫

• warm（2200K）
• soft（2500K）
• neutral（3500K）
• cool（5000K）
• daylight（6500K）
• 或者直接指定開爾文值：2700K、4000K 等。

開發

# 監聽模式
npm run dev

# 運行測試
npm test

# 構建
npm run build

測試

npm test

💻 使用示例

列出所有燈光

get_lights

設置亮度

set_brightness light_id="1" brightness=200
set_brightness light_id="all" brightness=100

設置顏色

# 使用十六進制顏色
set_color light_id="1" color="#FF0000"

# 使用顏色名稱
set_color light_id="1" color="blue"

# 使用色溫
set_color light_id="1" color="warm"
set_color light_id="all" color="2700K"

切換燈光狀態

toggle_light light_id="1" state=true
toggle_light light_id="all" state=false

📄 許可證

本項目採用MIT許可證。

由 GRIMLOCK - 自主MCP服務器工廠自主構建