io.github.sandraschi/mixx-dj-mcp
FastMCP server for Mixxx DJ software control via OSC protocol
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
https://github.com/sandraschi/mixx-dj-mcp/releases/download/v0.2.0/mixx-dj-mcp-v0.2.0.mcpbDocumentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
Mixx-DJ-MCP
AI-native DJ control for Mixxx. 80+ operations across decks, library, effects, mixer, stems, transitions, video, and more. Talk to your DJ software like a colleague.
Say: "Load Daft Punk on deck 2, sync it, cue the drop, then fade in on the next beat."
It happens.
First Run · Install · Tools · Status · Architecture · Video · AV Rig · NDI · NDI Targets · Beginner Guide · AI Transitions
One command to start
uv sync && uv run uvicorn mixx_dj_mcp.server:app --port 11116Configure Mixxx OSC once (one minute): Preferences > MIDI/OSC > Enable OSC, set out 11118, in 11119, send to 127.0.0.1, restart. Done.
Your AI assistant (Claude, Cursor, opencode) can now control your decks.
What it does
| You say | The AI does |
|---|---|
| "Play deck 2" | mixx_deck(operation="play_pause", deck=2) -- OSC to Mixxx |
| "Find some 128 BPM tech house" | mixx_library(operation="search", query="tech house") |
| "Add reverb to the outgoing track" | mixx_effects(operation="chain_load", rack=1, effect="Reverb") |
| "Plan a 30-min drum & bass set" | mixx_ai_set(operation="plan", style="drum and bass") |
| "Record this set" | mixx_recording(operation="start") |
| "Analyse this track's key" | mixx_analyze(operation="track", path="C:/Music/track.mp3") |
| "Show me my most-played tracks" | mixx_history(operation="profile") |
| "Transition with an echo out" | mixx_transition(operation="apply", effect="echo_out") |
Tools at a glance
| Tool | What it controls |
|---|---|
mixx_deck | Play/pause, load, cue, loops, sync, rate, scratch, hotcues, quantize, keylock -- plus video |
mixx_library | Search, browse crates/playlists, BPM/key metadata |
mixx_effects | Effect chains, parameters, quick effects, super knob |
mixx_mixer | Crossfader, EQ, gain, headphone cue, talkover, mic |
mixx_analyze | BPM detection, musical key (Krumhansl-Schmuckler), energy, cue suggestions |
mixx_stems | Demucs stem separation, sampler loading, stem-aware mixing |
mixx_transition | AI-suggested transitions, 8 effect types, auto-crossfader |
mixx_ai_set | Autonomous DJ -- plan sets, perform transitions, review |
mixx_recording | Record, replay, and export DJ sets as OSC streams |
mixx_history | Play history, style profile, track suggestions |
mixx_crate | LLM-generated smart crates by BPM/key/genre |
mixx_set | Harmonic mixing sequences, energy curve planning |
mixx_skin | List, apply, create video skins, AI palette generation |
mixx_vinyl | OCR catalog, AI gig picker, Plex crossref |
mixx_controller | USB auto-detect, install mappings |
mixx_daw | Export stems to DaVinci Resolve, Reaper |
| Prefab cards | show_deck/mixer/library_status_card -- rich in-chat UI |
Quick links
| For... | Read |
|---|---|
| Installing the server, webapp, NSIS installer, or MCPB | docs/INSTALL.md |
| Status & backlog | docs/STATUS.md · docs/TODO.md |
| Full tool reference with parameters, returns, and examples | docs/TOOLS.md |
| Using video -- requires the mixxxxx fork of Mixxx | docs/MIXXX_VIDEO.md |
| AV orchestrator (mixxxxx hub, NDI, Resolume, OBS) | docs/ORCHESTRATOR.md · webapp Help → AV Rig |
| NDI (network video from mixxxxx) | docs/NDI.md · docs/NDI-TARGETS.md · webapp Help → NDI |
| Project status & backlog | docs/STATUS.md · docs/TODO.md |
| AI-powered transitions between decks | docs/AI_TRANSITIONS.md |
| Architecture -- how the OSC bridge, REST API, and webapp work | docs/ARCHITECTURE.md |
| Beginner's guide to DJing with Mixxx | docs/NOOB_GUIDE.md |
| Comparing Mixxx to other DJ software | docs/DJ_LANDSCAPE.md |
| Algoriddim djay feature parity | docs/ALGORIDDIM_COMPARISON.md |
| Mixxx OSC setup and address reference | bridge/README.md |
Video DJing
Mixx-DJ-MCP supports the mixxxxx video fork -- a modified Mixxx build that adds FFmpeg video playback, per-deck video widgets, and fullscreen projector output alongside the standard audio engine.
mixxxxx on GitHub · docs/MIXXX_VIDEO.md
Ports
| Port | What |
|---|---|
| 11116 | Backend REST API + MCP transport |
| 11117 | React webapp (Vite) |
| 11118 | OSC feedback from Mixxx |
| 11119 | OSC commands to Mixxx |
Fleet integrations
Mixx-DJ-MCP is a Fleet Audio Hub -- it connects to other MCP servers for a unified DJ ecosystem:
| Server | Integration |
|---|---|
plex-mcp | Cross-reference vinyl with digital library |
songgeneration-mcp | AI music generation loaded direct to decks |
sfx-mcp | Sound effects triggered during live sets |
vfx-mcp | Real-time video effects on video output |
stems-mcp | External stem separation engine |
davinci-resolve-mcp | Export stems to Fairlight for post-production |
reaper-mcp | Export stems to Reaper DAW |
inkscape-mcp | AI skin colour palette generation |
Fleet Crossconnects (Companions)
mixx-dj-mcp works completely standalone. You can optionally connect it with companion servers in the sandraschi fleet to unlock extended features:
| Companion Server | Feature Unlocked | Status | Setup |
|---|---|---|---|
resolume-mcp | ndi-vj-routing, osc-clip-sync, live-projection-mapping | Optional | Install Guide |
resonite-mcp | virtual-world-stage, nekomimi-avatar-dance, osc-bpm-telemetry | Optional | Install Guide |
Self-Contained Companions: Fleet companions operate independently. Installing companions does not trigger transitive dependency chains.
License
MIT -- Sandra Schipal
Vinyl not included. Mixxx not included. Bad music taste is your own.
Questions fréquentes
Qu'est-ce que io.github.sandraschi/mixx-dj-mcp ?
FastMCP server for Mixxx DJ software control via OSC protocol
Comment installer io.github.sandraschi/mixx-dj-mcp ?
Suivez les étapes d'installation de sa documentation, affichée sur cette page et dans son dépôt.
Faut-il une clé API pour io.github.sandraschi/mixx-dj-mcp ?
Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.
io.github.sandraschi/mixx-dj-mcp est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient io.github.sandraschi/mixx-dj-mcp ?
Il est publié par sandraschi. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.