Huemcp

🚀 飛利浦 Hue MCP 服務器套件

用於控制飛利浦 Hue 智能燈的 MCP 服務器。

🚀 快速開始

對於 Claude 桌面端

1. 下載並安裝：從 發佈版本 下載並安裝 MCPB 套件。
2. 配置（二選一）：
   • 選項 A（推薦）：跳過配置，使用內置工具：
     • 使用 discover_bridge 工具查找你的 Hue 橋接器。
     • 按下你的 Hue 橋接器上的物理按鈕。
     • 使用 complete_bridge_setup 工具創建 API 密鑰。
   • 選項 B：在安裝過程中，在配置窗口中輸入橋接器 IP 地址和 API 密鑰。

對於其他 MCP 客戶端（例如 Cursor）

1. 克隆倉庫並安裝依賴：

git clone https://github.com/yourusername/HUEMCP.git
cd HUEMCP
yarn install

2. 設置（二選一）：
   • 選項 A：交互式設置（推薦）：

yarn setup

按照交互式提示配置你的橋接器。 - 選項 B：通過環境變量手動配置：

export HUE_BRIDGE_IP="your-bridge-ip"
export HUE_API_KEY="your-api-key"

3. 啟動服務器：

yarn start

需要橋接器 IP 地址和 API 密鑰？ 請參閱 手動設置指南，瞭解使用 mDNS 和 curl 的詳細步驟說明。

✨ 主要特性

• 通過 mDNS 自動發現橋接器
• 設置和配置 API 密鑰
• 控制燈光（開關、亮度、顏色）
• 管理 區域 和 房間
• 支持 分組燈光

🔧 技術細節

目前，此 MCP 服務器使用直接 HTTP 調用與飛利浦 Hue API v1 進行交互。

未來計劃

計劃遷移到 node - hue - api 庫，這將提供：

• 飛利浦 Hue API v2 的 TypeScript 實現
• 完整的 API 覆蓋和類型定義
• 場景管理和調度
• 用於流式傳輸顏色的娛樂 API
• 增強的性能和功能

📚 詳細文檔

完整的文檔可在 docs/ 中找到。

📦 資源

• 飛利浦 Hue API 文檔
• 飛利浦 Hue 官方開發者文檔
• node - hue - api GitHub 倉庫

📄 許可證

本項目採用 MIT 許可證。