概要
What is LIFX API MCP Server?
LIFX API MCP Server is a local Model Context Protocol (MCP) server that provides access to LIFX smart devices using natural language via LLMs. It allows users to list lights, set states, activate scenes, and trigger effects through the LIFX HTTP API.
How to use LIFX API MCP Server?
Obtain a LIFX API token from the LIFX Cloud settings page. Install the server via npx (npx -y lifx-api-mcp-server@latest) or Docker (docker run --rm -i --network=host furey/lifx-api-mcp-server). Configure the token using a config file (~/.lifx-api-mcp-server.jsonc), environment variable (CONFIG_API_TOKEN), or command-line argument. Set up an MCP client (e.g., Claude Desktop) and control lights using natural language. Use resources like lifx://lights and prompts like effect-creator.
Key features of LIFX API MCP Server
- 18 tools for LIFX device control and scene management
- Live resources: light list, light state, and scenes
- Prompts: effect-creator, troubleshooter, selector-helper
- Config file customization with component disabling
- Supports Docker, NPX, and source-based installation
- Uses standard LIFX selectors and color strings
Use cases of LIFX API MCP Server
- Control LIFX lights using natural language through an LLM client.
- Automate scene activation or light effects without manual scripting.
- Diagnose connectivity issues for specific lights with the troubleshooter prompt.
- Build custom light states and cycles for home automation.
- Integrate LIFX control into AI-driven workflows and assistants.
FAQ from LIFX API MCP Server
What are the runtime requirements?
Node.js v18+ (for NPX/source install) or Docker (for Docker install). A LIFX API token is required.
How do I configure the API token?
Set it via the config file (apiToken field in ~/.lifx-api-mcp-server.jsonc), environment variable (CONFIG_API_TOKEN), or command-line argument (least recommended). Priority follows that order.
Does the server store any data?
No. The server does not store or cache information permanently; all device data remains in the LIFX cloud.
What transport does the server use?
It uses stdio transport, as shown in the startup log output ("Creating stdio transport").
Can I disable specific tools, resources, or prompts?
Yes. Use the disabled or enabled keys in the config file to selectively disable or limit components.
