ykhli/mcp-light-control

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:
bash
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.
json
"mcpServers": {
"controllights": {
"command": "node",
"args": ["ABSOLUTEPATHTOMCPSERVER/build/index.js"],
"env": {
"HUEUSERNAME": "YOURHUEUSERNAME",
"BRIDGEIP": "YOURBRIDGEIP"
## 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=YOURCLIENTID&responsetype=code&state=anystring&appid=YOURAPPNAME&deviceid=test-device&devicename=TestDevice
Replace YOURCLIENTID and YOURAPPNAME 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).
e. Exchange the code for tokens using cURL or Postman:
bash
curl -X POST https://api.meethue.com/oauth2/token \
-d "code=YOURAUTHORIZATIONCODE&granttype=authorizationcode" \
-u "YOURCLIENTID:YOURCLIENTSECRET"
f. The response will contain:
json
"accesstoken": "YOURACCESSTOKEN",
"refreshtoken": "YOURREFRESHTOKEN",
"tokentype": "bearer",
"expiresin": 604800
Store these tokens securely. The access token is valid for approximately 7 days, and the refresh token for approximately 100 days.