iflow-mcp_mrkprdo-wled_mcp

# WLED MCP Server A Model Context Protocol (MCP) server for controlling WLED devices through LLM interactions. This server enables Claude and other LLMs to directly control your WLED smart lighting devices with natural language commands. ## Features - **Device Control**: Turn WLED devices on/off, adjust brightness (0-255) - **Color Management**: Set RGB colors with precise control - **Effects & Animation**: Access 100+ built-in lighting effects with customizable speed and intensity - **Presets**: Create, list, and activate saved lighting presets - **Palettes**: Browse and apply color palettes for effects - **Device Information**: Get detailed device status, capabilities, and configuration - **Advanced Control**: Use raw JSON API for complex operations and custom states ## ⚠️ IMPORTANT DISCLAIMER **USE AT YOUR OWN RISK**: This MCP server directly controls your WLED device and can modify its configuration, effects, colors, and settings. The author is **NOT LIABLE** for any damage, malfunction, or unintended behavior that may occur to your WLED device, LED strips, or related hardware when using this software. **STRONGLY RECOMMENDED BEFORE USE:** - **Backup your WLED configuration**: Export your current WLED config via the web interface (Config → Security & Updates → Backup Configuration) - **Save your presets**: Document or export any custom presets you want to keep - **Test on non-critical devices first**: Try this software on a test setup before using on important lighting installations - **Understand the risks**: This software can change brightness, colors, effects, and potentially overwrite your saved presets By using this software, you acknowledge that you understand these risks and agree that you are solely responsible for any consequences. ## Installation 1. Clone this repository: ```bash git clone https://github.com/mrkprdo/wled_mcp.git cd wled_mcp ``` 2. Install dependencies: ```bash pip install -e . ``` ## Quick Start ### 1. Configure Your WLE…