Lifx Api MCP Server

🚀 LIFX MCP 服务器

通过自然语言处理控制 LIFX 灯具的 MCP（多功能插件）服务器。支持使用英语或中文命令，如 "turn on the kitchen lights" 或 "让厨房灯亮起来"，轻松实现对灯具的智能控制。

✨ 主要特性

• 支持英语和中文指令，满足不同语言用户的使用需求。
• 内置多个工具，涵盖列表、设置状态、切换电源等常用功能。
• 提供多种提示功能，包括选择器助手、效果创建、故障排除等。
• 可配置的设置，允许用户自定义 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 密钥替换为你的实际密钥，并选择语言（中文或英文）。

使用说明

项目概述

此服务器允许你通过自然语言命令控制 LIFX 灯具。它支持多种功能，包括列出灯光、更改状态、切换电源等。

工具列表

• 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 仓库。