Lifx Lan MCP

LIFX LAN MCP is a server based on the Model Context Protocol (MCP) that allows an LLM to control LIFX smart lights via the local network without cloud connection. It provides functions such as querying the light list, getting states, controlling on/off, and adjusting colors, and supports two communication modes: stdio and HTTP.

Home automation and IoT Developer tools #Smart Lighting Control #Local Network #MCP Protocol #Lighting Management Local .TypeScript

rating : 2 points

downloads : 7

update time : 2025-04-29

What is LIFX LAN MCP?

LIFX LAN MCP is a locally running server that allows you to control the LIFX smart lighting system in your home through a Large Language Model (LLM). You can turn lights on and off, adjust colors, etc., without an internet connection.

How to use LIFX LAN MCP?

First, ensure that your LIFX bulbs are connected to the same WiFi network and install the server on your device. Then, select the method to control the lights as needed, such as listing all lights or setting the color of a specific light.

Applicable Scenarios

This tool is ideal for home users who want to manage and automate their home lighting through voice or text commands, especially those who wish to reduce their reliance on cloud services.

Main Features

List All LightsGet a list of all LIFX lights currently connected to the same local area network and their basic information.

Get Light StateView the current state of the selected light, including color, brightness, and on/off status.

Set Light ColorChange the color of one or more lights, supporting the specification of Hue, Saturation, Brightness, and Kelvin values.

Turn On LightsTurn on a specified group of lights and optionally change their color at the same time.

Turn Off LightsTurn off a specified group of lights, supporting a smooth transition effect.

Advantages and Limitations

Advantages

Runs completely locally without relying on external cloud services

Simple to operate with fast response

Supports multiple lighting control methods

Limitations

Needs to run within the same local area network

There are security risks in HTTP mode (authentication is not enabled)

How to Use

Install and Start the Server

After downloading and installing the Node.js environment, run the following command to start the server: `npx lifx-lan-mcp`.

Configure the Client

Add the MCP server address to your LLM client configuration file, for example: `"url": "http://localhost:3000/mcp"`.

Execute Lighting Control

Send corresponding instructions to the server, such as listing all lights or adjusting the brightness of the lights in a certain room.

Usage Examples

Example 1: List All LightsSend a request to the server to display all LIFX lights in your home and their locations.

Example 2: Adjust Light ColorChange the color of the bedroom lights to blue.

Frequently Asked Questions

Does the server require an internet connection?

How to ensure security in HTTP mode?

Related Resources

Official GitHub Repository

The storage location of source code and documentation

Introduction to MCP Protocol

Understand the basics of the Model Context Protocol

Technical Support Email

Contact the developer for help

🚀 LIFX Local Area Network MCP Project

The LIFX Local Area Network MCP project is a toolset for controlling LIFX smart lights. It enables interaction with LIFX lights through the Model Context Protocol (MCP). The project offers various functions, including querying light status, adjusting light color, and controlling the on/off state.

🚀 Quick Start

📦 Installation

Clone the repository

git clone https://github.com/simon-duchastel/lifx-lan-mcp.git
cd lifx-lan-mcp

Install dependencies

npm install

Build the project

npm run build

💻 Running Mode

Development environment preparation

Node.js
TypeScript
LIFX lights connected to the local area network

Code structure

The MCP definition is located in index.ts, which contains all tools available for large language models to call. The API interfaces are implemented in the src/ directory.

✨ Features

1. Query light status

Tool name: lifx_lan_get_light_status
Function description: Get the status information of specified LIFX lights, including color, on/off state, group, and location.

Input parameters:

labels (string[]): List of labels of the lights to be queried

2. Set light color

Tool name: lifx_lan_set_light_color
Function description: Adjust the color parameters of specified LIFX lights, supporting gradient transition effects.

Input parameters:

labels (string[]): List of labels of the lights to be adjusted
color (object): Color configuration parameters
- hue (number): Hue value (Range: 0.0 - 1.0)
- saturation (number): Saturation value (Range: 0.0 - 1.0)
- brightness (number): Brightness value (Range: 0.0 - 1.0)
- kelvin (number, optional): Color temperature value (Unit: Kelvin, Range: 1500 - 9000, Default: 3500)
duration (number, optional): Transition duration (Unit: milliseconds)

3. Turn on lights

Tool name: lifx_lan_turn_on_lights
Function description: Turn on specified LIFX lights, with optional color adjustment.

Input parameters:

labels (string[]): List of labels of the lights to be turned on
color (object, optional): Color configuration parameters (optional)
- hue (number, optional): Hue value
- saturation (number, optional): Saturation value
- brightness (number, optional): Brightness value
- kelvin (number, optional): Color temperature value
duration (number, optional): Transition duration