该MCP服务器允许光标或Claude桌面使用摩尔斯电码控制飞利浦Hue灯具并发送消息。

💡 示例用例💡：告诉光标代理在完成任务后向你发送摩尔斯电码消息。

演示

https://www.youtube.com/watch?v=GM1l98TtZmk

构建材料：

• 飞利浦Hue API
• 拟人MCP
• 光标

布置

先决条件

• 飞利浦Hue桥梁和灯具
• Hue 桥用户名（API 密钥）
• Node.js（v14或更高）
• 光标或Claude桌面

本地 API 设置

1. 在本地克隆该仓库。
2. 获取您的飞利浦Hue桥接IP地址和用户名。如果没有，运行发现脚本：

按照提示点击Hue桥上的链接按钮，即可获得API密钥。

3. 在项目目录中运行 npm install 和 npm run build。这将生成 /build 目录中的 MCP 服务器脚本。

4. 添加以下MCP配置。在光标中，它在设置 -> MCP -> 添加新的MCP服务器。在Claude Desktop中，它在设置 -> MCP -> 添加新的MCP服务器。

远程API设置

Morse Code Light MCP Server (Philips Hue) 💡

This MCP server allows Cursor or Claude Desktop to control Philips Hue lights and send messages through them using Morse code.

💡Example use case💡: tell Cursor agent to send a Morse code message to you when it’s done with a task.

Demo

https://www.youtube.com/watch?v=GM1l98TtZmk

Built with:

• Philips Hue API
• Anthropic MCP
• Cursor

Setup

Prerequisites

• Philips Hue bridge and lights
• Hue bridge username (API key)
• Node.js (v14 or higher)
• Cursor or Claude Desktop

Local API Setup

1. Clone this repository locally.

2. Obtain your Philips Hue bridge IP address and username. If you don’t have one, run the discovery script:

   node build/discover-bridge.js
   

   Follow the prompts to press the link button on your Hue bridge and receive your API key.

3. Run npm install followed by npm run build in the project directory. This will generate the MCP server script in the /build directory.

4. Add the following MCP configuration. In Cursor it’s under Settings -> MCP -> Add new MCP server. In Claude Desktop it’s under Settings -> MCP -> Add new MCP server.

{
  "mcpServers": {
    "control_lights": {
      "command": "node",
      "args": ["ABSOLUTE_PATH_TO_MCP_SERVER/build/index.js"],
      "env": {
        "HUE_USERNAME": "YOUR_HUE_USERNAME",
        "BRIDGE_IP": "YOUR_BRIDGE_IP"
      }
    }
  }
}

Remote API Setup

This project supports controlling your Philips Hue lights remotely (from outside your local network) using the Hue Remote API. This enables you to control your lights from anywhere with an internet connection.

Getting Remote API Credentials

1. Create a Hue Developer Account:

   • Register at https://developers.meethue.com/

2. Create a Remote Hue API App:

   • Go to https://developers.meethue.com/my-apps/
   • Create a new app with these details:
     • App name: Choose a name for your app
     • Callback URL: Use http://localhost/ for simple testing
     • Application description: Brief description of your app
   • After creating the app, you’ll receive:
     • Client ID
     • Client Secret

3. Get Access and Refresh Tokens:

   a. Construct an authorization URL and open it in your browser:

   https://api.meethue.com/oauth2/auth?clientid=YOUR_CLIENT_ID&response_type=code&state=anystring&appid=YOUR_APP_NAME&deviceid=test-device&devicename=TestDevice
   

   Replace YOUR_CLIENT_ID and YOUR_APP_NAME with your values.

   b. Log in with your Hue developer account and authorize the app.

   c. You’ll be redirected to your callback URL with a code parameter.

   d. Extract the code from the URL (e.g., ?code=abcd1234&state=anystring).