OpenHue MCP Server 使用说明

项目简介

OpenHue MCP Server 是一个 MCP (Model Context Protocol) 服务器，它充当大型语言模型 (LLM) 与 Philips Hue 智能照明系统之间的桥梁。通过定义一系列工具，该服务器使得 LLM 能够以标准化的方式理解和控制 Hue 灯光，实现基于自然语言的智能家居灯光管理。例如，用户可以通过 Claude 等 LLM，使用自然语言指令来控制家中的 Philips Hue 灯光。

主要功能点

Philips Hue 灯光控制: 提供工具，允许 LLM 控制 Philips Hue 灯泡、房间和场景。
工具化接口: 功能以工具 (Tools) 的形式暴露给 LLM，例如 'get-lights' (获取灯列表), 'control-light' (控制灯光), 'activate-scene' (激活场景) 等。
MCP 协议兼容: 遵循 Model Context Protocol 协议，可以与任何兼容 MCP 协议的 LLM 客户端 (如 Claude Desktop) 无缝集成。
Dockerized OpenHue CLI: 后端通过 Docker 运行 OpenHue CLI，与 Philips Hue Bridge 进行通信。

安装步骤

环境准备: 确保已安装 Node.js (v16 或更高版本) 和 Docker，并已按照仓库 README 的 "Bridge Setup" 部分完成 Philips Hue Bridge 和 OpenHue CLI 的配置。
克隆仓库: 使用 'git clone <仓库URL>' 命令克隆代码仓库到本地。
安装依赖: 在项目根目录下，运行 'npm install' 命令安装项目依赖。
构建项目: 运行 'npm run build' 命令编译 TypeScript 代码。
启动服务器: 运行 'npm start' 命令启动 MCP 服务器。

服务器配置 (MCP 客户端)

要将此 MCP 服务器连接到 MCP 客户端（例如 Claude Desktop），需要在客户端中配置服务器的启动命令。以下是 Claude Desktop 客户端的 'claude_desktop_config.json' 配置文件示例：

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

'"hue"': 服务器名称，可以自定义。
'"command": "node"': 启动服务器的命令，这里使用 Node.js 运行 JavaScript 文件。
'"args": ["/absolute/path/to/openhue-mcp-server/build/index.js"]': 命令参数，指向编译后的服务器入口文件 'index.js' 的绝对路径。请将 '/absolute/path/to/openhue-mcp-server' 替换为实际的项目本地绝对路径。

基本使用方法

配置并启动 MCP 服务器，并在 MCP 客户端 (如 Claude Desktop) 中完成配置连接后，即可使用自然语言指令控制 Philips Hue 灯光。例如，在 Claude 中可以提问：

"客厅有哪些灯？"
"关闭卧室的灯。"
"把厨房的灯光调成蓝色，亮度 70%。"
"激活客厅的'电影之夜'场景。"

注意: 请确保 Claude Desktop 客户端已正确配置并成功连接到 MCP 服务器 ( hammer icon 图标亮起)。

关键词

OpenHue MCP Server 使用说明

信息