light-mcp-server

Contrôleur lumière DMX (Art-Net / sACN) open source. On le pilote depuis une interface web temps réel (WebSocket), en MIDI ou OSC depuis Ableton et les contrôleurs, ou par une IA via MCP.

Statut : en développement (v0). Installation et premiers pas : docs/install.md (sources, Docker) ou docs/install-npm.md (paquet @bawaaaaah/light-mcp-server sur GitHub Packages ; image ghcr.io/bawaaaaah/light-mcp-server). Sur le Mac de régie, une app de barre de menus lance et surveille le serveur : macos/README.md. Reprendre le projet : docs/HANDOFF.md. Feuille de route : docs/roadmap.md.

En bref

• Architecture inspirée de bawaaaaah/wing-mcp-server : Node/TypeScript, un core/ générique et un plugin light, avec une seule couche de commandes pour l’UI, le MIDI, l’OSC, le MCP, la timeline et la CLI.
• Sortie Art-Net 4 avec découverte des nodes, et sACN. Jusqu’à 16 univers.
• Lieu, scène et canevas : on écrit les effets sur un canevas abstrait, rendu ensuite sur le kit de chaque salle. La scène virtuelle (zones, hauteurs, orientations, rôles) est lisible par l’IA.
• Techniques à pas (damier, palette qui tourne, masques, orage…) avec attaque et cadence au BPM, et effets par forme d’onde.
• Groupes unifiés : sous-groupes, master proportionnel façon DCA, exclusivité, limites.
• Règles de sécurité : modes interdits, max UV, zones protégées, scènes sans intensité, politique strobe, Panic neutre et Blackout.
• MIDI :
  • entrées locales et RTP-MIDI auto-détectées ;
  • modes Déclencher, Latch et Momentané, registre de notes, retour sur port distinct, MIDI clock et SPP ;
  • export de MIDI Effect Rack Ableton et génération de Live Set.
• Chants et setlist : grille de conception, boutons et/ou timeline, feuille de conduite, planche.
• Dashboards modulables FR/EN : glisser-déposer, redimensionnement par les coins, grille magnétique, couleurs, plein écran, sur ordinateur, tablette et téléphone ; console DMX par projecteur ; éditeurs d’effets, d’easing et de timing ; notes partout.
• Shows et sauvegardes comme une console lumière : nouveau, dupliquer, réinitialiser, sauvegarde automatique quotidienne, versions précédentes et objets supprimés récupérables ; un objet encore utilisé ne se supprime pas par mégarde.
• Utilisateurs et rôles (PIN, clés de sécurité, OAuth pour claude.ai), droits appliqués à l’interface comme au MCP, journal d’activité (qui a fait quoi, d’où).
• Données en fichiers texte (git) et archives .lightshow, CLI light et SDK de scripts, plugins.

Démarrer

npm run build && npm start        # http://localhost:8790 ; MCP sur /mcp
npm run light -- token            # le jeton d'authentification (jamais écrit dans les journaux)