A
securityA
licenseA
qualityIntegrate Claude with Any OpenAI SDK Compatible Chat Completion API - OpenAI, Perplexity, Groq, xAI, PyroPrompts and more.
Last updated -
1
27
140
MIT License
OpenHue MCP 服务器
MCP 服务器可使用 OpenHue CLI 通过 Claude 和其他 LLM 接口控制飞利浦 Hue 灯。
先决条件
Node.js （v16 或更高版本）
Claude 桌面版（可选，用于测试）
桥接设置
在使用服务器之前，您需要使用 Hue Bridge 设置 OpenHue CLI：
运行安装命令：
# 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
按照屏幕上的说明进行操作：
CLI 将搜索您的 Hue Bridge
出现提示时，按下 Hue Bridge 上的链接按钮
等待确认设置完成
通过列出灯光来验证设置：
# 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 服务器了。
安装
克隆存储库：
git clone <your-repo-url>
cd claude-mcp-openhue
安装依赖项：
npm install
构建项目：
npm run build
运行服务器：
npm start
特征
该服务器通过 MCP 公开以下功能：
灯光控制
列出所有灯光或获取特定灯光的详细信息
打开/关闭灯
调整亮度
设置颜色
控制色温
房间控制
列出所有房间或获取房间详细信息
同时控制房间内的所有灯光
设置整个房间的亮度和颜色
场景管理
列出可用场景
使用不同模式激活场景
按房间过滤场景
与 Claude Desktop 一起使用
打开您的 Claude Desktop 配置文件：
macOS：
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows：
%APPDATA%\Claude\claude_desktop_config.json
添加服务器配置：
{
"mcpServers": {
"hue": {
"command": "node",
"args": ["/absolute/path/to/build/index.js"]
}
}
}
重启Claude桌面
查找锤子图标以验证服务器是否已连接
示例命令
连接后，您可以向 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
故障排除
服务器未连接
检查 Docker 是否正在运行
验证 OpenHue 配置是否存在
检查 Claude Desktop 日志
尝试直接运行 OpenHue CLI
命令失败
检查 OpenHue CLI 权限
验证灯光/房间/场景名称
检查 Docker 容器日志
验证 Hue Bridge 连接
执照
MIT 许可证
贡献
分叉存储库
创建你的功能分支
提交你的更改
推送到分支
创建新的 Pull 请求
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
使用 OpenHue CLI 通过 Claude 和其他 LLM 接口控制飞利浦 Hue灯。
Related MCP Servers
- -securityAlicense-qualityEnables users to control Govee LED devices using the Govee API, with features for turning devices on/off, setting colors, and adjusting brightness through a CLI or MCP clients.Last updated -3MIT License
- -securityFlicense-qualityA Model Context Protocol interface that enables AI assistants like Claude to control Philips Hue smart lighting systems through natural language commands.Last updated -10
- -securityAlicense-qualityEnables Claude to interact with Qlik Cloud applications and extract data from visualizations through the Qlik Cloud API.Last updated -5MIT License