Mixx Dj
FreeNot checkedMixxx DJ control via FastMCP — 40+ tools: decks, stems (Demucs), video decks, crates, OSC bridge. Pair with mixxxxx fork. For Cursor / Claude Desktop. Webapp +
About
Mixxx DJ control via FastMCP — 40+ tools: decks, stems (Demucs), video decks, crates, OSC bridge. Pair with mixxxxx fork. For Cursor / Claude Desktop. Webapp + Tauri.
README
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.
GitHub stars License Python FastMCP Mixxx React Tauri NSIS
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
AI-native DJ control for Mixxx - 80+ operations across decks, library, effects, mixer, stems, transitions and video via OSC.
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 |
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.
Installing Mixx Dj
This server has no published package — it is built from source. Open the repository and follow its README.
▸ github.com/sandraschi/mixx-dj-mcpFAQ
Is Mixx Dj MCP free?
Yes, Mixx Dj MCP is free — one-click install via Unyly at no cost.
Does Mixx Dj need an API key?
No, Mixx Dj runs without API keys or environment variables.
Is Mixx Dj hosted or self-hosted?
Self-hosted: the server runs locally on your machine via the install command above.
How do I install Mixx Dj in Claude Desktop, Claude Code or Cursor?
Open Mixx Dj on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.
Related MCPs
ARA
Generate images, video and audio from any AI agent — one connector.
by ARAOmni Video
An MCP server that transforms LLM-enabled IDEs into professional video editors by pre-processing footage into text proxies, generating motion graphics via HTML/
by buildwithtazaYouTube
Transcripts, channel stats, search
by YouTubeEverArt
AI image generation using various models.
by modelcontextprotocolgpu-bridge/mcp-server
GPU inference API for LLMs, image and video generation, TTS, Whisper, embeddings, reranking and OCR, paid per use via x402 or an API key.
by gpu-bridgemerterbak/Grok-MCP
Access xAI's Grok API with agentic tool calling, image generation, vision and file support.
by merterbakSureScaleAI/openai-gpt-image-mcp
Image generation and editing with OpenAI's GPT image models.
by SureScaleAIYangLiangwei/PersonalizationMCP
Aggregate personal data from Steam, YouTube, Bilibili, Spotify, Reddit and other gaming, music, video and social platforms, with OAuth2 and token management.
by YangLiangweiAceDataCloud/MCPFlux
Flux image generation and editing from Black Forest Labs via the Ace Data Cloud API.
by AceDataCloudAceDataCloud/MCPNanoBanana
Nano Banana image generation and editing, including virtual try-on and product placement in realistic scenes.
by AceDataCloudCompare Mixx Dj with
Not sure what to pick?
Find your stack in 60 seconds
Author?
Embed badge for your README
Browse similar
All media MCPs
