OpenHue MCP 服务器

一个 MCP 服务器，它允许通过 Claude 和其他 LLM 接口，使用 OpenHue CLI 控制 Philips Hue 灯。

前提条件

• Node.js (v16 或更高版本)
• Docker
• Claude for Desktop (可选，用于测试)

Bridge 设置

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

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 Bridge
   • 出现提示时，按下 Hue Bridge 上的链接按钮
   • 等待确认设置完成

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 公开以下功能：

灯光控制

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

房间控制

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

场景管理

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

与 Claude Desktop 一起使用

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

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. 添加服务器配置：

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

3. 重启 Claude Desktop

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

示例命令

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

• "客厅里有哪些灯？"
• "打开厨房里的所有灯"
• "将卧室的灯设置为 50% 亮度"
• "将办公室的灯改为蓝色"
• "激活 '放松' 场景"
• "书房里有哪些场景可用？"

可用工具

get-lights

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

{
  lightId?: string;  // 可选的灯 ID 或名称
  room?: string;     // 可选的房间名称过滤器
}

control-light

控制单个灯

{
  target: string;    // 灯 ID 或名称
  action: "on" | "off";
  brightness?: number; // 0-100
  color?: string;     // 颜色名称
  temperature?: number; // 153-500 Mirek
}

get-rooms

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

{
  roomId?: string;  // 可选的房间 ID 或名称
}

control-room

控制房间内的所有灯

{
  target: string;    // 房间 ID 或名称
  action: "on" | "off";
  brightness?: number;
  color?: string;
  temperature?: number;
}

get-scenes

列出可用的场景

{
  room?: string;    // 可选的房间名称过滤器
}

activate-scene

激活特定场景

{
  name: string;     // 场景名称或 ID
  room?: string;    // 可选的房间名称
  mode?: "active" | "dynamic" | "static";
}

开发

项目结构

.
├── src/
│   └── index.ts    # 主要服务器实现
├── build/          # 编译后的 JavaScript
├── package.json
├── tsconfig.json
└── README.md

构建

npm run build

运行

npm start

故障排除

服务器未连接

1. 检查 Docker 是否正在运行
2. 验证 OpenHue 配置是否存在
3. 检查 Claude Desktop 日志
4. 尝试直接运行 OpenHue CLI

命令失败

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

许可证

MIT 许可证

贡献

1. Fork 存储库
2. 创建您的功能分支
3. 提交您的更改
4. 推送到分支
5. 创建一个新的 Pull Request