Servidor LIFX MCP

Un servidor MCP basado en TypeScript para controlar luces inteligentes LIFX a través de la API HTTP oficial de LIFX.

Características

Controlar las luces LIFX mediante herramientas MCP
Establecer estado, alternar y aplicar efectos (respirar, mover, transformar, llama)
Activar escenas y analizar cadenas de colores
Creado con FastMCP para una fácil integración

Empezando

Prerrequisitos

Node.js (se recomienda v16+)
Un token API de LIFX Cloud ( consíguelo aquí )
Cliente compatible con MCP (por ejemplo, VS Code)

Instalación

git clone https://github.com/your-org/mcp-lifx.git
cd mcp-lifx
npm install

Construir

npm run build

Correr

Puedes iniciar el servidor directamente:

npm start

O utilice herramientas MCP (recomendado):

npx fastmcp dev src/index.ts

Uso con VS Code

Para una instalación rápida, utilice uno de los botones de instalación de un solo clic en la parte superior de este README.

Para la instalación manual, agregue el siguiente bloque JSON a su archivo de configuración de usuario (JSON) en VS Code. Para ello, presione Ctrl + Shift + P y escriba Preferences: Open User Settings (JSON) .

Opcionalmente, puede agregarlo a un archivo llamado .vscode/mcp.json en su espacio de trabajo. Esto le permitirá compartir la configuración con otros.

Tenga en cuenta que la clave mcp no es necesaria en el archivo .vscode/mcp.json .

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "lifx_token",
        "description": "LIFX Cloud API Token",
        "password": true
      }
    ],
    "servers": {
      "lifx": {
        "command": "npx",
        "args": ["-y", "mcp-lifx"],
        "env": {
          "LIFX_TOKEN": "${input:lifx_token}"
        }
      }
    }
  }
}

Configuración

El servidor requiere un token de API LIFX. Puedes proporcionarlo mediante:

Archivo .env :
LIFX_TOKEN=your_lifx_token_here
O a través del indicador de extensión MCP de VS Code (consulte .vscode/mcp.json ).

Uso

El servidor expone las siguientes herramientas MCP:

get-lights : Obtener el estado de las luces mediante el selector
set-state : establece el estado (potencia, color, brillo, etc.)
set-states : Establece varios estados a la vez
set-state-delta : Aplicar cambios delta
toggle-lights : Activar y desactivar la alimentación
breathe-effect , move-effect , morph-effect , flame-effect : Efectos de ejecución
get-scenes , activate-scene : Gestión de escenas
parse-color : Analiza cadenas de color

Ejemplo: Encender y apagar una luz

{
  "tool": "toggle-lights",
  "parameters": {
    "selector": "label:Lamp"
  }
}

Desarrollo

Fuente de TypeScript: src/
Salida de compilación: build/
Tipos y esquemas: src/types.ts
Servidor FastMCP: src/index.ts

Guiones

npm run build – Compilar TypeScript para build/
npm start – Ejecuta el servidor compilado
npm run dev – Ejecutar con tsx para desarrollo
npm run inspect – Inspeccionar con FastMCP Inspector

Referencia de API

Consulte .docs/lifxapi.md para obtener detalles completos de la API de LIFX y los formatos de color.

Licencia

ISC

Este proyecto no está afiliado a LIFX. Úselo bajo su propio riesgo.

LIFX MCP Server