À propos du projet

Mixx-DJ-MCP est un serveur MCP (Model Context Protocol) qui donne aux assistants IA un contrôle direct sur l'application DJ open-source Mixxx. Il est décrit comme « contrôle DJ natif IA pour Mixxx », exposant plus de 80 opérations couvrant decks, bibliothèque, effets, mixeur, stems, transitions et vidéo. Fonctionnement : le serveur fait le pont entre les appels d'outils MCP et Mixxx via OSC. Mixxx doit être configuré une fois (Préférences > MIDI/OSC > Activer OSC, sortie 11118, entrée 11119, envoyer à 127.0.0.1). Ensuite, des assistants comme Claude, Cursor ou opencode peuvent émettre des commandes en langage naturel qui correspondent à des appels d'outils, par exemple charger une piste sur un deck, synchroniser, placer un cue, ou fondre en fondu à la prochaine mesure. Le démarrage se fait par une seule commande utilisant uv : synchroniser les dépendances et lancer le serveur uvicorn sur le port 11116. Les ports sont documentés : 11116 backend REST API + transport MCP, 11117 webapp React (Vite), 11118 retour OSC de Mixxx, 11119 commandes OSC vers Mixxx. Surface d'outils (telle que listée dans le README) : mixx_deck (play/pause, chargement, cue, boucles, sync, taux, scratch, hotcues, quantize, keylock, plus vidéo), mixx_library (recherche, navigation crates/playlists, métadonnées BPM/clé), mixx_effects (chaînes, paramètres, effets rapides, super bouton), mixx_mixer (crossfader, EQ, gain, cue casque, talkover, micro), mixx_analyze (détection BPM, clé musicale via Krumhansl-Schmuckler, énergie, suggestions de cues), mixx_stems (séparation de stems Demucs, chargement de samplers, mixage conscient des stems), mixx_transition (transitions suggérées par IA, huit types d'effets, auto-crossfader), mixx_ai_set (planification de set autonome, exécution de transitions, revue), mixx_recording (enregistrement, relecture, export de sets sous forme de flux OSC), mixx_history (historique de lecture, profil de style, suggestions), mixx_crate (crates intelligents générés par LLM selon BPM/clé/genre), mixx_set (séquences de mixage harmonique, planification de courbe d'énergie), mixx_skin (lister/appliquer/créer des skins vidéo, génération de palettes IA), mixx_vinyl (catalogue OCR, sélecteur de gig IA, référence croisée Plex), mixx_controller (détection automatique USB, installation de mappings), mixx_daw (export de stems vers DaVinci Resolve, Reaper), et cartes préfabriquées pour une interface riche dans le chat (statut deck/mixeur/bibliothèque). Le DJing vidéo est pris en charge via le fork séparé « mixxxxx » de Mixxx, qui ajoute la lecture vidéo FFmpeg, des widgets vidéo par deck et une sortie projecteur plein écran aux côtés du moteur audio. La documentation associée couvre un orchestrateur AV (NDI, Resolume, OBS), des cibles NDI, des transitions IA, l'architecture, un guide pour débutants et des comparaisons avec d'autres logiciels DJ. Au-delà du serveur MCP, le projet inclut une webapp React 19 + Tauri 2.0 et un installateur NSIS. Il décrit également des intégrations « Fleet Audio Hub » avec d'autres serveurs MCP : plex-mcp, songgeneration-mcp, sfx-mcp, vfx-mcp, stems-mcp, davinci-resolve-mcp, reaper-mcp, inkscape-mcp et speech-mcp (DJing contrôlé par la voix). Sous licence MIT (Sandra Schipal). Mixxx et le vinyle ne sont pas inclus.