Mixx Dj Mcp

io.github.sandraschiPublished by GitHub account sandraschiv0.2.0Updated Oct 26, 2026

FastMCP server for Mixxx DJ software control via OSC protocol

VerifiedSTDIODesktop onlyMedia & DesignAI & ML

Overview

AI-generated overview

Controls Mixxx DJ software through OSC, letting an assistant run decks, library, effects, mixer, stems, transitions and video from chat.

What you can do
  • Play, load, cue, loop, sync and scratch decks, including video output
  • Search and browse the library, crates, playlists and BPM/key metadata
  • Manage effect chains, mixer levels, crossfader, EQ and mic
  • Analyse tracks for BPM, key and energy, and separate stems
  • Plan sets, suggest and apply transitions, record and export sets
  • Show in-chat status cards for decks, mixer and library
When to use it
Useful when you DJ with Mixxx and want an assistant to drive the software hands-free: loading and syncing tracks, searching the library, shaping effects and mixer moves, planning harmonic sets, or recording a session.
Requirements
Runs locally as a Python project started with uv (uv sync and uv run uvicorn on port 11116). Mixxx must be installed with OSC enabled in Preferences, sending to 127.0.0.1 on ports 11118 and 11119. Video features need a separate modified Mixxx fork.
Before you install
It sends live control commands to your DJ software, so assistant actions can change playback, mixer levels and recordings during a session. Stem separation and analysis process local audio files by path. Optional companion servers add further integrations and are installed separately.

Installation

In SourceWeft

  1. Open Mixx Dj Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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.

[Mixx-DJ-MCP Cockpit]
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

bash
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 sayThe 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

ToolWhat it controls
mixx_deckPlay/pause, load, cue, loops, sync, rate, scratch, hotcues, quantize, keylock -- plus video
mixx_librarySearch, browse crates/playlists, BPM/key metadata
mixx_effectsEffect chains, parameters, quick effects, super knob
mixx_mixerCrossfader, EQ, gain, headphone cue, talkover, mic
mixx_analyzeBPM detection, musical key (Krumhansl-Schmuckler), energy, cue suggestions
mixx_stemsDemucs stem separation, sampler loading, stem-aware mixing
mixx_transitionAI-suggested transitions, 8 effect types, auto-crossfader
mixx_ai_setAutonomous DJ -- plan sets, perform transitions, review
mixx_recordingRecord, replay, and export DJ sets as OSC streams
mixx_historyPlay history, style profile, track suggestions
mixx_crateLLM-generated smart crates by BPM/key/genre
mixx_setHarmonic mixing sequences, energy curve planning
mixx_skinList, apply, create video skins, AI palette generation
mixx_vinylOCR catalog, AI gig picker, Plex crossref
mixx_controllerUSB auto-detect, install mappings
mixx_dawExport stems to DaVinci Resolve, Reaper
Prefab cardsshow_deck/mixer/library_status_card -- rich in-chat UI

Quick links

For...Read
Installing the server, webapp, NSIS installer, or MCPBdocs/INSTALL.md
Status & backlogdocs/STATUS.md · docs/TODO.md
Full tool reference with parameters, returns, and examplesdocs/TOOLS.md
Using video -- requires the mixxxxx fork of Mixxxdocs/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 & backlogdocs/STATUS.md · docs/TODO.md
AI-powered transitions between decksdocs/AI_TRANSITIONS.md
Architecture -- how the OSC bridge, REST API, and webapp workdocs/ARCHITECTURE.md
Beginner's guide to DJing with Mixxxdocs/NOOB_GUIDE.md
Comparing Mixxx to other DJ softwaredocs/DJ_LANDSCAPE.md
Algoriddim djay feature paritydocs/ALGORIDDIM_COMPARISON.md
Mixxx OSC setup and address referencebridge/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

PortWhat
11116Backend REST API + MCP transport
11117React webapp (Vite)
11118OSC feedback from Mixxx
11119OSC commands to Mixxx

Fleet integrations

Mixx-DJ-MCP is a Fleet Audio Hub -- it connects to other MCP servers for a unified DJ ecosystem:

ServerIntegration
plex-mcpCross-reference vinyl with digital library
songgeneration-mcpAI music generation loaded direct to decks
sfx-mcpSound effects triggered during live sets
vfx-mcpReal-time video effects on video output
stems-mcpExternal stem separation engine
davinci-resolve-mcpExport stems to Fairlight for post-production
reaper-mcpExport stems to Reaper DAW
inkscape-mcpAI 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 ServerFeature UnlockedStatusSetup
resolume-mcpndi-vj-routing, osc-clip-sync, live-projection-mappingOptionalInstall Guide
resonite-mcpvirtual-world-stage, nekomimi-avatar-dance, osc-bpm-telemetryOptionalInstall 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.

Source: README.md at commit 1b97174

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.2.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts