OpenHue MCP Server

OpenHue MCP服务器

一个MCP服务器，可以使用OpenHue CLI通过Claude和其他LLM接口控制飞利浦秀灯。

先决条件

• （v16或更高版本）
• 码头工人
• Claude桌面版 （可选，用于测试）

桥梁设置

在使用服务器之前，您需要使用Hue Bridge设置OpenHue CLI：

1. 运行安装命令：

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

# On Windows (PowerShell):
docker run -v "${env:USERPROFILE}\.openhue:/.openhue" --rm --name=openhue -it openhue/cli setup

1. 按照屏幕上的说明进行操作：

- CLI将搜索您的Hue Bridge - 出现提示时，按下Hue桥接器上的链接按钮 - 等待安装完成的确认

1. 通过列出灯光来验证设置：

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

# On Windows (PowerShell):
docker run -v "${env:USERPROFILE}\.openhue:/.openhue" --rm --name=openhue -it openhue/cli get lights

如果您看到列出的灯，则表示设置已完成，您已准备好使用MCP服务器。

安装

1. 克隆存储库：

git clone 
cd claude-mcp-openhue

1. 安装依赖项：

npm install

1. 构建项目：

npm run build

1. 运行服务器：

npm start

特性

此服务器通过MCP公开以下功能：

灯光控制

• 列出所有灯光或获取特定灯光详细信息
• 打开/关闭灯
• 调整亮度
• 设置颜色
• 控制色温

房间控制

• 列出所有房间或获取房间详细信息
• 一起控制房间里的所有灯
• 设置整个房间的亮度和颜色

场景管理

• 列出可用场景
• 使用不同模式激活场景
• 按房间过滤场景

使用Claude Desktop

1. 打开您的Claude Desktop配置文件：

- macOS： ~/Library/Application Support/Claude/claude_desktop_config.json - 窗户： %APPDATA%\Claude\claude_desktop_config.json

1. 添加服务器配置：

{
  "mcpServers": {
    "hue": {
      "command": "node",
      "args": ["/absolute/path/to/build/index.js"]
    }
  }
}

1. 重新启动克劳德桌面

1. 查找锤子图标以验证服务器是否已连接

示例命令

连接后，您可以向Claude提出自然语言问题，例如：

• “客厅里有什么灯？”
• “打开厨房里的所有灯”
• “将卧室灯设置为50%亮度”
• “将办公室灯换成蓝色”
• “激活‘放松’场景”
• “书房里有什么场景？”

可用工具

获取灯光

列出所有灯光或获取特定灯光的详细信息

{
  lightId?: string;  // Optional light ID or name
  room?: string;     // Optional room name filter
}

控制灯

控制单个灯光

{
  target: string;    // Light ID or name
  action: "on" | "off";
  brightness?: number; // 0-100
  color?: string;     // Color name
  temperature?: number; // 153-500 Mirek
}

预订房间

列出所有房间或获取特定房间详细信息

{
  roomId?: string;  // Optional room ID or name
}

控制室

控制房间内的所有灯光

{
  target: string;    // Room ID or name
  action: "on" | "off";
  brightness?: number;
  color?: string;
  temperature?: number;
}

获取场景

列出可用场景

{
  room?: string;    // Optional room name filter
}

激活场景

激活特定场景

{
  name: string;     // Scene name or ID
  room?: string;    // Optional room name
  mode?: "active" | "dynamic" | "static";
}

发展

项目结构

.
├── src/
│   └── index.ts    # Main server implementation
├── build/          # Compiled JavaScript
├── package.json
├── tsconfig.json
└── README.md

建筑

npm run build

跑步

npm start

故障排除

服务器未连接

1. 检查Docker是否正在运行
2. 验证OpenHue配置是否存在
3. 检查克劳德桌面日志
4. 尝试直接运行OpenHue CLI

命令失败

1. 检查OpenHue CLI权限
2. 验证灯光/房间/场景名称
3. 检查Docker容器日志
4. 验证Hue桥接连接

许可证

MIT许可证

贡献

1. 分叉存储库
2. 创建功能分支
3. 提交您的更改
4. 推到分支
5. 创建新的Pull请求