lightflows-mcp

SamuraiBuddha/lightflows-mcp

3.2

If you are the rightful owner of lightflows-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

LightFlows MCP is a server that integrates AI-powered natural language control with RGB lighting systems using the OpenRGB platform.

Tools
3
Resources
0
Prompts
0

LightFlows MCP 🌈

An MCP (Model Context Protocol) server for OpenRGB - enabling AI-powered RGB lighting choreography and control through natural language.

Overview

LightFlows MCP bridges the gap between AI assistants and RGB lighting control, allowing you to create complex lighting effects and choreographies using simple commands like:

  • "Set all my RGB to a calming blue"
  • "Create a thunderstorm effect across all devices"
  • "Sync my keyboard breathing with my case fans"
  • "Build a sunset gradient from left to right"

Features (Planned)

Core Functionality

  • 🎨 Device Discovery - Automatically detect all OpenRGB-compatible devices
  • 🎯 Precise Control - Set colors by device, zone, or individual LED
  • 🎭 Mode Management - Switch between static, breathing, rainbow, and custom effects
  • 💾 Profile Support - Save and load complete lighting configurations

Advanced Features

  • 🌊 Flow Creation - Design complex multi-device lighting sequences
  • 🎵 Music Sync - React to audio input (when combined with LlamaBeats MCP)
  • 🎬 Scene Integration - Coordinate with OBS scenes (via Argos MCP)
  • ⏰ Scheduling - Time-based lighting changes

Architecture

Built on OpenRGB's robust SDK:

  • Network protocol on port 6742
  • Binary protocol with "ORGB" magic header
  • Support for 100+ device types across multiple manufacturers

Installation

# Clone the repository
git clone https://github.com/SamuraiBuddha/lightflows-mcp.git
cd lightflows-mcp

# Install dependencies
npm install

# Configure Claude desktop
# Add to claude_desktop_config.json:
{
  "lightflows": {
    "command": "node",
    "args": ["path/to/lightflows-mcp/index.js"]
  }
}

Usage Examples

"Turn off all RGB"
"Make my RAM sticks pulse red during meetings"
"Create a police siren effect"
"Match my lighting to my desktop wallpaper colors"

Requirements

  • OpenRGB running with SDK server enabled
  • Node.js 18+
  • Compatible RGB devices

Contributing

Contributions welcome! This project is part of a larger ecosystem of media control MCPs.

Related Projects

License

MIT