Lifx Lan MCP

🚀 LIFX局域網MCP項目

本項目是一個用於控制LIFX智能燈具的工具集，藉助模型上下文協議（Model Context Protocol, MCP）與LIFX燈具進行交互。它提供了查詢燈具狀態、調整燈光顏色、開關控制等實用功能。

🚀 快速開始

開發環境準備

• Node.js
• TypeScript
• LIFX燈具接入局域網

克隆倉庫

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

安裝依賴

npm install

構建項目

npm run build

✨ 主要特性

• 狀態查詢：可獲取指定LIFX燈具的狀態信息，如顏色、開關狀態、分組及位置等。
• 顏色調整：支持調整指定LIFX燈具的顏色參數，還能實現漸變過渡效果。
• 開關控制：能開啟或關閉指定LIFX燈具，開啟時可選配顏色調整，關閉時支持漸變關閉效果。

💻 使用示例

基礎用法

查詢燈具狀態

# 調用 lifx_lan_get_light_status 工具查詢燈具狀態
# 假設需要查詢標籤為 ["light1", "light2"] 的燈具狀態
labels = ["light1", "light2"]
# 這裡假設存在調用工具的函數
status = lifx_lan_get_light_status(labels)
print(status)

設置燈具顏色

# 調用 lifx_lan_set_light_color 工具設置燈具顏色
labels = ["light1"]
color = {
    "hue": 0.5,
    "saturation": 0.8,
    "brightness": 0.9,
    "kelvin": 4000
}
duration = 2000  # 過渡持續時間為 2000 毫秒
# 這裡假設存在調用工具的函數
lifx_lan_set_light_color(labels, color, duration)

打開燈具

# 調用 lifx_lan_turn_on_lights 工具打開燈具
labels = ["light2"]
color = {
    "hue": 0.2,
    "saturation": 0.7,
    "brightness": 0.8
}
duration = 1500  # 過渡持續時間為 1500 毫秒
# 這裡假設存在調用工具的函數
lifx_lan_turn_on_lights(labels, color, duration)

關閉燈具

# 調用 lifx_lan_turn_off_lights 工具關閉燈具
labels = ["light1"]
duration = 1000  # 過渡持續時間為 1000 毫秒
# 這裡假設存在調用工具的函數
lifx_lan_turn_off_lights(labels, duration)

📚 詳細文檔

代碼結構

MCP定義位於index.ts，包含所有可供大語言模型調用的工具。API接口實現於src/目錄中。

功能工具詳情

1. 查詢燈具狀態

工具名稱: lifx_lan_get_light_status
功能描述: 獲取指定LIFX燈具的狀態信息，包括顏色、開關狀態、分組及位置等。

輸入參數:

• labels (string[]): 需要查詢的燈具標籤列表

2. 設置燈具顏色

工具名稱: lifx_lan_set_light_color
功能描述: 調整指定LIFX燈具的顏色參數，支持漸變過渡效果。

輸入參數:

• labels (string[]): 需要調整的燈具標籤列表
• color (object): 顏色配置參數
  • hue (number): 色調值（範圍：0.0 - 1.0）
  • saturation (number): 飽和度值（範圍：0.0 - 1.0）
  • brightness (number): 明亮度值（範圍：0.0 - 1.0）
  • kelvin (number, optional): 色溫值（單位：開爾文，範圍：1500 - 9000，默認值：3500）
• duration (number, optional): 過渡持續時間（單位：毫秒）

3. 打開燈具

工具名稱: lifx_lan_turn_on_lights
功能描述: 開啟指定LIFX燈具，可選配顏色調整。

輸入參數:

• labels (string[]): 需要開啟的燈具標籤列表
• color (object, optional): 顏色配置參數（可選）
  • hue (number, optional): 色調值
  • saturation (number, optional): 飽和度值
  • brightness (number, optional): 明亮度值
  • kelvin (number, optional): 色溫值
• duration (number, optional): 過渡持續時間

4. 關閉燈具

工具名稱: lifx_lan_turn_off_lights
功能描述: 關閉指定LIFX燈具，支持漸變關閉效果。

輸入參數:

• labels (string[]): 需要關閉的燈具標籤列表
• duration (number, optional): 過渡持續時間

🔧 技術細節

MCP定義位於index.ts，包含所有可供大語言模型調用的工具。API接口實現於src/目錄中，通過這些接口實現與LIFX燈具的交互。

📄 許可證

本項目採用MIT許可證，具體內容詳見LICENSE文件。

📞 聯繫方式

如有任何問題或建議，歡迎通過以下方式聯繫：

• 郵件: lifx-lan-mcp@duchastel.com
• GitHub ISSUE: https://github.com/simon-duchastel/lifx-lan-mcp/issues

如果該項目對您有幫助，可以考慮通過Buy Me a Coffee支持作者。

⚠️ 重要提示

使用HTTP服務器模式時，請確保網絡環境安全，防止未授權訪問。

💡 使用建議

項目基於Node.js開發，需提前安裝相關依賴項。