wiz-mcp-server

🚀 WIz MCP Server

WIz MCP Server 是一个轻量级的 MCP 服务器，它通过 UDP 协议提供 Wiz 智能灯的控制工具。

🚀 快速开始

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python3 server.py

✨ 主要特性

工具列表

• get_status(ip, include_raw=false)

  • 返回一个标准化的类似 LightStatus 的对象。
  • 当 include_raw=true 时，可选择返回原始的 UDP 响应。

• set_color(ip, r, g, b, dimming=null, fetch_status=false, include_raw=false)

  • 发送包含 RGB（以及可选的调光）信息的 setPilot 指令。
  • 可选择在设置后获取最新的状态信息。

⚠️ 注意事项

⚠️ 重要提示

该服务器使用 UDP 端口 38899 与 Wiz 灯泡进行通信。

💡 使用建议

若遇到 Operation not permitted 错误，请在允许 UDP 通信的主机上运行该服务器。