OpenHue MCP Server

OpenHue MCP Server

site icon
2025.01.03 0
TypeScript智能家居控制灯光管理位置服务
OpenHue MCP Server 是一个通过 Claude 和其他 LLM 接口控制 Philips Hue 灯光的 MCP 服务器。它提供了对灯光的全面控制,包括开关、亮度调节、颜色设置等功能,并支持通过自然语言命令进行操作。
View on GitHub

Overview

基本能力

产品定位

OpenHue MCP Server 是一个智能家居控制服务器,专门用于通过自然语言接口控制 Philips Hue 灯光系统。

核心功能

  • 灯光控制:开关、亮度调节、颜色设置、色温控制
  • 房间控制:批量控制房间内所有灯光
  • 场景管理:场景激活和查询

适用场景

  • 通过自然语言控制智能家居灯光
  • 创建自动化灯光场景
  • 集成到智能家居系统中

工具列表

  1. get-lights:列出所有灯光或获取特定灯光详情
  2. control-light:控制单个灯光
  3. get-rooms:列出所有房间或获取特定房间详情
  4. control-room:控制房间内所有灯光
  5. get-scenes:列出可用场景
  6. activate-scene:激活特定场景

常见问题解答

  1. 服务器连接问题:检查 Docker 是否运行,验证 OpenHue 配置
  2. 命令执行失败:检查权限、名称是否正确,验证 Hue Bridge 连接

使用教程

使用依赖

  1. Node.js (v16 或更高版本)
  2. Docker
  3. (可选) Claude for Desktop

安装教程

  1. 克隆仓库:
git clone <your-repo-url>
cd claude-mcp-openhue
  1. 安装依赖:
npm install
  1. 构建项目:
npm run build
  1. 运行服务器:
npm start

调试方式

  1. 检查 Docker 容器日志
  2. 直接运行 OpenHue CLI 进行测试
  3. 查看 Claude Desktop 日志

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。