金大哥 - lifx-api-mcp-server MCP 详情

article

README

🚀 LIFX MCP 服务器

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

✨ 主要特性

支持英语和中文指令，满足不同语言用户的使用需求。
内置多个工具，涵盖列表、设置状态、切换电源等常用功能。
提供多种提示功能，包括选择器助手、效果创建、故障排除等。
可配置的设置，允许用户自定义 API 密钥和语言偏好。
支持 Docker，方便快捷地进行部署。

📦 安装指南

克隆仓库：

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

安装依赖项：
```
npm install -g lifx-api-mcp-server
```
启动服务器：
```
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 仓库。

lifx-api-mcp-server