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 11116
Configure 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 |
speech-mcp | Voice-controlled DJing ("Hey Mixxx, load deck 2...") |
License
MIT — Sandra Schipal
Vinyl not included. Mixxx not included. Bad music taste is your own.