huemcp

🚀 飞利浦 Hue MCP 服务器套件

用于控制飞利浦 Hue 智能灯的 MCP 服务器。

🚀 快速开始

对于 Claude 桌面端

1. 下载并安装：从 发布版本 下载并安装 MCPB 套件。
2. 配置（二选一）：
   • 选项 A（推荐）：跳过配置，使用内置工具：
     • 使用 discover_bridge 工具查找你的 Hue 桥接器。
     • 按下你的 Hue 桥接器上的物理按钮。
     • 使用 complete_bridge_setup 工具创建 API 密钥。
   • 选项 B：在安装过程中，在配置窗口中输入桥接器 IP 地址和 API 密钥。

对于其他 MCP 客户端（例如 Cursor）

1. 克隆仓库并安装依赖：

git clone https://github.com/yourusername/HUEMCP.git
cd HUEMCP
yarn install

2. 设置（二选一）：
   • 选项 A：交互式设置（推荐）：

yarn setup

按照交互式提示配置你的桥接器。 - 选项 B：通过环境变量手动配置：

export HUE_BRIDGE_IP="your-bridge-ip"
export HUE_API_KEY="your-api-key"

3. 启动服务器：

yarn start

需要桥接器 IP 地址和 API 密钥？ 请参阅 手动设置指南，了解使用 mDNS 和 curl 的详细步骤说明。

✨ 主要特性

• 通过 mDNS 自动发现桥接器
• 设置和配置 API 密钥
• 控制灯光（开关、亮度、颜色）
• 管理 区域 和 房间
• 支持 分组灯光

🔧 技术细节

目前，此 MCP 服务器使用直接 HTTP 调用与飞利浦 Hue API v1 进行交互。

未来计划

计划迁移到 node - hue - api 库，这将提供：

• 飞利浦 Hue API v2 的 TypeScript 实现
• 完整的 API 覆盖和类型定义
• 场景管理和调度
• 用于流式传输颜色的娱乐 API
• 增强的性能和功能

📚 详细文档

完整的文档可在 docs/ 中找到。

📦 资源

• 飞利浦 Hue API 文档
• 飞利浦 Hue 官方开发者文档
• node - hue - api GitHub 仓库

📄 许可证

本项目采用 MIT 许可证。