Lifx Api MCP Server

🚀 LIFX MCP 服務器

通過自然語言處理控制 LIFX 燈具的 MCP（多功能插件）服務器。支持使用英語或中文命令，例如 "turn on the kitchen lights" 或 "讓廚房燈亮起來"，為用戶提供便捷的燈具控制體驗。

🚀 快速開始

此服務器允許你通過自然語言命令控制 LIFX 燈具。它支持多種功能，包括列出燈光、更改狀態、切換電源等。

✨ 主要特性

• 支持英語和中文指令，滿足不同語言用戶的需求。
• 內置多個工具，如列表、設置狀態、切換電源等，功能豐富。
• 提供多種提示功能，包括選擇器助手、效果創建、故障排除等，方便用戶操作。
• 可配置的設置，涵蓋 API 密鑰和語言偏好，靈活性高。
• 支持 Docker，方便進行部署。

📦 安裝指南

1. 克隆倉庫：

   git clone https://github.com/furey/lifx-api-mcp-server.git
   cd lifx-api-mcp-server
   

2. 安裝依賴項：

   npm install -g lifx-api-mcp-server
   

3. 啟動服務器：

   lifx-api-mcp-server
   

📚 詳細文檔

配置

創建一個包含以下內容的配置文件 config.json：

{
  "lifxApiKey": "your_api_key_here",
  "language": "zh" // 或者 "en"
}

將 API 密鑰替換為你的實際密鑰，並選擇語言（中文或英文）。

工具列表

• list-lights：列出所有燈具。
• set-state：設置燈具的狀態（開/關）。
• toggle-power：切換燈具的電源狀態。
• state-delta：調整燈具的屬性（亮度、顏色等）。

提示示例

基礎用法

• 列出可用燈光：

  @lix-api:lifx://lights
  

• 獲取特定燈的狀態：

  @lix-api:lifx://light/label:你的燈名/state
  

高級用法

• 使用選擇器助手：

  @lix-api:selector-helper 目標：廚房的燈
  

• 創建效果：

  @lix-api:effect-creator 效果類型：呼吸 選擇器：所有 燈描述：非常緩慢地變為暖白色
  

• 故障排除：

  @lix-api:troubleshooter 選擇器："id:d073d5xxxxxx"
  

Docker 支持

使用以下 Dockerfile 構建鏡像：

FROM node:18-alpine

WORKDIR /app

# 複製包文件
COPY package*.json ./

# 安裝依賴項（生產模式）
RUN npm ci --omit=dev --production --no-fund --no-audit

# 複製應用程序代碼
COPY . .

# 設置入口點
ENTRYPOINT ["node", "lifx-api-mcp-server.js"]

# 默認命令（如有需要可以覆蓋）
# CMD ["YOUR_DEFAULT_TOKEN_IF_NEEDED"]

⚠️ 重要提示

• 本軟件按現狀提供，不附帶任何明示或暗示的保證。
• 使用前請確保安裝 Node.js 和 npm。
• 如遇問題，請查看文檔或聯繫開發者。

💡 使用建議

如需幫助或反饋問題，請訪問 GitHub 倉庫。