LIFX MCP サーバー

公式 LIFX HTTP API を介してLIFXスマートライトを制御するための TypeScript ベースのMCPサーバー。

特徴

MCPツールを使用してLIFXライトを制御する
状態を設定し、切り替え、エフェクト（呼吸、移動、変形、炎）を適用します
シーンをアクティブにしてカラー文字列を解析する
簡単に統合できるFastMCPで構築

はじめる

前提条件

Node.js (v16以上を推奨)
LIFX Cloud API トークン (こちらから入手)
MCP 互換クライアント (例: VS Code)

インストール

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

建てる

npm run build

走る

サーバーを直接起動することもできます:

npm start

または、MCP ツールを使用します (推奨):

npx fastmcp dev src/index.ts

VS Codeでの使用

素早くインストールするには、この README の上部にあるワンクリックインストールボタンのいずれかを使用します。

手動でインストールする場合は、VS Code のユーザー設定 (JSON) ファイルに次の JSON ブロックを追加します。Ctrl Ctrl + Shift + Pを押してPreferences: Open User Settings (JSON)と入力すると、このブロックを追加できます。

オプションとして、ワークスペース内の.vscode/mcp.jsonというファイルに追加することもできます。これにより、他のユーザーと設定を共有できるようになります。

.vscode/mcp.jsonファイルではmcpキーは必要ないことに注意してください。

{
  "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}"
        }
      }
    }
  }
}

構成

サーバーにはLIFX APIトークンが必要です。以下の方法で提供できます。

.envファイル:
LIFX_TOKEN=your_lifx_token_here
または、VS Code MCP 拡張プロンプト経由 ( .vscode/mcp.jsonを参照)。

使用法

サーバーは次の MCP ツールを公開します。

get-lights : セレクターでライトの状態を取得する
set-state : 状態を設定する（電源、色、明るさなど）
set-states : 複数の状態を一度に設定する
set-state-delta : デルタ変更を適用する
toggle-lights ：電源のオン/オフ
breathe-effect 、 move-effect 、 morph-effect 、 flame-effect ：実行エフェクト
get-scenes 、 activate-scene :シーン管理
parse-color : 色文字列を解析する

例: ライトのオン/オフ

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

発達

TypeScriptソース: src/
ビルド出力: build/
型とスキーマ: src/types.ts
FastMCP サーバー: src/index.ts

スクリプト

npm run build – TypeScriptをコンパイルしてbuild/
npm start – コンパイルされたサーバーを実行する
npm run dev – 開発用にtsxで実行
npm run inspect – FastMCP Inspectorで検査する

APIリファレンス

LIFX API の詳細とカラー形式については.docs/lifxapi.mdを参照してください。

ライセンス

ISC

このプロジェクトはLIFXとは一切関係ありません。自己責任でご利用ください。

LIFX MCP Server