LIFX MCP Server

A Model Context Protocol (MCP) server that provides tools for controlling LIFX smart lights through the LIFX HTTP API.

Features

This MCP server exposes the following LIFX API functionality as tools:

• 🔍 list_lights - Get all lights or filter by selector

• ⚡ set_state - Control power, color, brightness of lights

• 🔄 toggle_power - Toggle lights on/off

• 🫁 breathe_effect - Create breathing light effects

• 💫 pulse_effect - Create pulsing light effects

• 🎬 list_scenes - List all saved scenes

• ▶️ activate_scene - Activate a specific scene

• ✅ validate_color - Validate color string formats

• ⏹️ effects_off - Turn off any running effects

🎨 Interactive MCP App

NEW! This server includes an interactive web-based UI that provides:

• Visual controls for all your LIFX lights

• Real-time power, color, and brightness adjustments

• One-click color presets

• Visual effects (breathe & pulse) controls

• Theme-aware design that adapts to your client

See MCP_APP_GUIDE.md for details on using the interactive UI.

Prerequisites

1. LIFX API Token: Get your token from LIFX Cloud Settings

2. Node.js: Version 16 or higher

3. VS Code with GitHub Copilot extension

Installation

1. Clone this repository:

git clone https://github.com/lenvolk/mcp-lifx.git
cd mcp-lifx

2. Install dependencies:

npm install

3. Build the project:

npm run build

Usage

With VS Code and GitHub Copilot

The LIFX MCP server works seamlessly with VS Code's GitHub Copilot:

1. Ensure the server is built: npm run build

2. Set your LIFX_API_TOKEN environment variable

3. The server will be automatically discovered by VS Code's MCP integration

4. Open GitHub Copilot Chat and interact with your lights

Example interactions:

• "List all my LIFX lights"

• "Open LIFX control" - launches the interactive UI with visual controls

• "Show LIFX app" - alternative way to open the control interface

• "Turn on the kitchen lights"

• "Set living room lights to blue"

• "Launch LIFX dashboard" - opens the visual control panel

Running the Server

You can run the server directly with:

npm start

Or in development mode:

npm run serve

Example Usage

Once connected to an MCP client, you can use commands like:

Text Commands

• "List all my LIFX lights"

• "Turn on the kitchen lights"

• "Set living room lights to blue"

• "Start a breathe effect on all lights with red color"

• "Show me all my saved scenes"

• "Activate the movie night scene"

Interactive UI

Launch the visual control interface with any of these prompts:

• "Open LIFX control" - Primary command to launch the UI

• "Show LIFX app" - Alternative prompt

• "Launch LIFX interface" - Opens the interactive controls

• "Open LIFX dashboard" - Displays the visual UI

• "Show me LIFX controls" - Launches the control panel

• "Open the LIFX control panel" - Starts the interactive interface

• "I want to control my LIFX lights visually" - Opens the UI

• "Show LIFX remote" - Alternative way to access controls

The interactive UI provides visual controls for power, brightness, colors, and effects without needing text commands. See MCP_APP_GUIDE.md for details.

LIFX Selectors

Use selectors to target specific lights:

• all - All lights

• label:Kitchen - Lights labeled "Kitchen"

• group:Living Room - Lights in "Living Room" group

• location:Home - Lights at "Home" location

• id:d073d5000000 - Specific light by ID

Color Formats

The server supports various color formats:

• Named colors: red, blue, green, purple, etc.

• RGB: rgb:255,0,0 (red)

• HSB: hue:120 saturation:1.0 brightness:0.5

• Kelvin: kelvin:3500 (warm white)

Development

Project Structure

mcp-lifx/
├── src/
│   ├── index.ts          # Main MCP server implementation
│   ├── mcp-app.tsx       # React MCP app UI
│   └── mcp-app.html      # HTML entry point for app
├── build/
│   ├── index.js          # Compiled server
│   └── src/
│       └── mcp-app.html  # Bundled single-file app UI
├── LIFX.md               # LIFX API documentation
├── MCP_APP_GUIDE.md      # Interactive UI usage guide
├── mcp.md                # MCP tutorial reference
├── vite.config.ts        # Vite build configuration
├── package.json          # Project configuration
├── tsconfig.json         # TypeScript configuration
└── README.md             # This file

Available Scripts

• npm run build - Build both the MCP app UI and server

• npm run build:app - Build only the React UI

• npm run build:server - Build only the TypeScript server

• npm start - Run the compiled server

• npm run serve - Run server in development mode (with tsx)

• npm run dev - Build and run in one command

• npm run clean - Remove build directory

• npm run rebuild - Clean and rebuild everything

API Reference

All LIFX API endpoints and parameters are documented in LIFX.md.

Contributing

1. Fork the repository

2. Create a feature branch

3. Make your changes

4. Test thoroughly

5. Submit a pull request

License

ISC License

Support

For issues with this MCP server, please open an issue on GitHub. For LIFX API issues, refer to the official LIFX API documentation.

Note: This is an unofficial LIFX MCP server. LIFX is a trademark of LIFX Pty Ltd.