Openhue

🚀 OpenHue MCP 服務器

OpenHue MCP 服務器藉助 OpenHue CLI 實現對飛利浦 Hue 燈光的控制，並且支持與 Claude 及其他大語言模型（LLM）接口進行交互，為燈光控制帶來更智能、便捷的體驗。

🚀 快速開始

在使用服務器之前，需要先完成一些準備工作，包括安裝必要的軟件和設置 Hue 門橋。

先決條件

• Node.js (v16 或更高版本)
• Docker
• Claude 桌面版（可選，用於測試）

門橋設置

在使用服務器之前，需要通過 OpenHue CLI 設置與您的 Hue 門橋：

1. 運行安裝命令：

# 在 Linux/macOS 上：
docker run -v "${HOME}/.openhue:/.openhue" --rm --name=openhue -it openhue/cli setup

# 在 Windows（PowerShell）上：
docker run -v "${env:USERPROFILE}\.openhue:/.openhue" --rm --name=openhue -it openhue/cli setup

2. 按照屏幕上的指示操作：
   • CLI 會搜索您的 Hue 門橋
   • 在提示時按下 Hue 門橋的鏈接按鈕
   • 等待確認設置完成
3. 通過列出燈光進行驗證：

# 在 Linux/macOS 上：
docker run -v "${HOME}/.openhue:/.openhue" --rm --name=openhue -it openhue/cli get lights

# 在 Windows（PowerShell）上：
docker run -v "${env:USERPROFILE}\.openhue:/.openhue" --rm --name=openhue -it openhue/cli get lights

如果看到列出的燈光，說明設置完成，您可以開始使用 MCP 服務器。

📦 安裝指南

1. 克隆倉庫：

git clone <your-repo-url>
cd claude-mcp-openhue

2. 安裝依賴項：

npm install

3. 構建項目：

npm run build

4. 運行服務器：

npm start

✨ 主要特性

此服務器通過 MCP 提供以下功能：

燈光控制

• 列出所有燈光或指定燈光的信息
• 開啟/關閉燈光
• 調整亮度和顏色

房間控制

• 獲取房間信息
• 獲取房間內所有燈光狀態
• 控制房間內的燈光

場景管理

• 創建、刪除和更新場景
• 列出所有場景
• 應用指定的場景

📚 詳細文檔

開發

項目結構

.
├── src/
│   └── index.ts    # 主服務器實現文件
├── build/          # 編譯後的 JavaScript 文件夾
├── package.json
├── tsconfig.json
└── README.md

構建

npm run build

運行

npm start

故障排除

服務器無法連接

1. 檢查 Docker 是否在運行
2. 驗證 OpenHue 配置是否存在
3. 查看 Claude 桌面版日誌
4. 嘗試直接運行 OpenHue CLI

命令失敗

1. 檢查 OpenHue CLI 權限
2. 確認燈光/房間/場景名稱正確
3. 查看 Docker 容器日誌
4. 驗證 Hue 門橋連接性

📄 許可證

MIT License

🔧 貢獻

1. 叉取倉庫
2. 創建功能分支
3. 提交您的更改
4. 推送到分支
5. 提出新的 Pull Request