项目介绍
wld
💡 从命令行控制 WLED 灯光
功能
使用此工具，您可以：
- 按名称保存和管理多个 WLED 设备
- 设置默认设备以快速访问
- 通过终端开关您的 WLED 设备
- 设置 WLED 设备的亮度（0-255 或 0-100%）
- 通过已保存的名称或直接通过 IP 地址控制设备
安装
macOS 或 Linux 通过 Homebrew
- 运行
brew tap timrogers/tap && brew install wld安装最新版本。 - 运行
wld --help查看所有功能并检查是否安装成功。
macOS、Linux 或 Windows 通过 Cargo，Rust 的包管理器
- 如果尚未安装，请在您的机器上安装 Rust。
- 运行
cargo install wld安装wld包。 - 运行
wld --help查看所有功能并检查是否安装成功。
macOS、Linux 或 Windows 通过直接下载二进制文件
- 下载适用于您平台的 最新版本。支持 macOS、Linux 和 Windows 设备。
- 将二进制文件添加到
$PATH，以便可以从 shell 执行它。为了获得最佳体验，在 macOS 和 Linux 上将其命名为wld，在 Windows 上命名为wld.exe。 - 运行
wld --help查看所有功能并检查是否安装成功。
使用方法
命令行
wld CLI 提供以下命令：
设备管理
-
wld add <name> <ip>：按友好名称添加新的 WLED 设备。第一个添加的设备会自动成为默认设备。wld add desk-light 192.168.1.100 -
wld delete <name>：从配置中删除已保存的设备。wld delete desk-light -
wld ls：列出所有已保存的设备。默认设备标记为(default)。wld ls -
wld set-default <name>：设置默认设备，用于未指定设备的命令。wld set-default desk-light
设备控制
-
wld on：打开默认设备，或者通过--device/-d指定设备。wld on # 打开默认设备 wld on -d desk-light # 打开特定的已保存设备 wld on -d 1 92.168.1.100 # 通过 IP 地址打开设备 -
wld off：关闭默认设备，或者通过--device/-d指定设备。wld off # 关闭默认设备 wld off -d desk-light # 关闭特定的已保存设备 wld off -d 192.168.1.100 # 通过 IP 地址关闭设备 -
wld brightness <value>：设置默认设备的亮度，或者通过--device/-d指定设备。亮度值必须在 0 到 255 之间，如果使用--percentage/-p，则必须在 0 到 100 之间。wld brightness 128 # 将默认设备的亮度设为一半 wld brightness 50 -p # 将默认设备的亮度设为 50% wld brightness 255 -d desk-light # 将特定的已保存设备的亮度设为最大 wld brightness 0 -d 192.168.1.100 # 将设备的亮度设为最小 -
wld status：检查所有配置设备的状态。显示每个设备是 ON、OFF 还是 UNREACHABLE。wld status # 检查所有已保存设备的状态
通过模型上下文协议 (MCP) 客户端
运行 wld mcp 命令启动本地模型上下文协议 (MCP) 服务器，允许您通过 AI 应用程序和代理控制 WLED 设备。
与 Claude Desktop 结合使用
要使用 MCP 服务器与 Claude Desktop：
- 在 Claude 应用程序中，打开“开发者”菜单，然后点击“打开应用配置文件...”。
- 在您的配置中的
mcpServers键下添加 MCP 服务器：
{
"mcpServers": {
"wld": {
"command": "wld",
"args": [
"mcp"
]
}
}
}
- 回到 Claude 应用程序，打开“开发者”菜单，然后点击“重新加载 MCP 配置”。
- 要检查 MCP 服务器是否正在运行，开始一个聊天，然后点击聊天输入下方的“搜索和工具”按钮，并检查菜单中是否有“wld”项。
可用工具
提供以下工具：
wled_devices：从配置中列出保存的 WLED 设备，包括它们的名称、IP 地址以及哪个设备被设置为默认设备wled_on：打开 WLED 设备。默认情况下使用默认设备，但可以选择指定设备名称或 IP 地址。wled_off：关闭 WLED 设备。默认情况下使用默认设备，但可以选择指定设备名称或 IP 地址。wled_brightness：设置 WLED 设备的亮度（0-255）。默认情况下使用默认设备，但可以选择指定设备名称或 IP 地址。wled_status：检查所有配置的 WLED 设备的状态。显示每个设备是 ON、OFF 还是 UNREACHABLE。