OpenHue MCP Server
2024.12.24
8
TypeScript智能家居控制灯光管理位置服务
OpenHue MCP Server 是一个用于通过Claude和其他LLM接口控制Philips Hue灯光的MCP服务器。它提供了对Hue灯光的全面控制能力，包括灯光开关、亮度调节、颜色设置、场景管理等。用户可以通过自然语言命令与Claude交互，实现对智能家居灯光的便捷控制。
View on GitHub
Overview
基本能力
产品定位
OpenHue MCP Server 是一个智能家居灯光控制中间件，专注于为LLM应用提供Philips Hue灯光的控制能力。
核心功能
- 灯光控制
- 列出所有灯光或获取特定灯光详情
- 开关灯光
- 调节亮度
- 设置颜色
-
控制色温
-
房间控制
- 列出所有房间或获取房间详情
- 统一控制房间内所有灯光
-
设置房间整体亮度和颜色
-
场景管理
- 列出可用场景
- 激活不同模式的场景
- 按房间筛选场景
适用场景
- 通过自然语言控制智能家居灯光
- 创建智能灯光自动化场景
- 集成到LLM应用中实现语音/文字控制
- 开发智能家居相关应用
工具列表
- get-lights - 列出所有灯光或获取特定灯光详情
- control-light - 控制单个灯光
- get-rooms - 列出所有房间或获取特定房间详情
- control-room - 控制房间内所有灯光
- get-scenes - 列出可用场景
- activate-scene - 激活特定场景
常见问题解答
- 服务器连接问题
- 检查Docker是否运行
- 验证OpenHue配置是否存在
- 检查Claude Desktop日志
-
尝试直接运行OpenHue CLI
-
命令执行失败
- 检查OpenHue CLI权限
- 验证灯光/房间/场景名称
- 检查Docker容器日志
- 验证Hue Bridge连接性
使用教程
使用依赖
- 安装Node.js (v16或更高版本)
- 安装Docker
- (可选)安装Claude for Desktop用于测试
安装教程
- 克隆仓库:
git clone <your-repo-url>
cd claude-mcp-openhue
- 安装依赖:
npm install
- 构建项目:
npm run build
- 运行服务器:
npm start
调试方式
- 验证Hue Bridge设置:
# 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
- 检查服务器日志
- 测试基本命令:
# 获取灯光列表
# 控制单个灯光
# 获取房间列表