{
  "markdown": "<div align=\"center\">\n  <br/>\n  <h1>Mixx-DJ-MCP</h1>\n  <p><strong>AI-native DJ control for Mixxx.</strong> 80+ operations across decks, library, effects, mixer, stems, transitions, video, and more. Talk to your DJ software like a colleague.</p>\n  <br/>\n\n[![GitHub stars](https://img.shields.io/github/stars/sandraschi/mixx-dj-mcp?style=flat-square&logo=github)](https://github.com/sandraschi/mixx-dj-mcp)\n[![License](https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square)](LICENSE)\n[![Python](https://img.shields.io/badge/Python-3.12-3776AB?style=flat-square&logo=python&logoColor=white)](https://python.org)\n[![FastMCP](https://img.shields.io/badge/FastMCP-3.4-purple?style=flat-square)](https://github.com/jlowin/fastmcp)\n[![Mixxx](https://img.shields.io/badge/Mixxx-2.5-orange?style=flat-square)](https://mixxx.org)\n[![React](https://img.shields.io/badge/React-19-61DAFB?style=flat-square&logo=react&logoColor=white)](https://react.dev)\n[![Tauri](https://img.shields.io/badge/Tauri-2.0-FFC131?style=flat-square&logo=tauri&logoColor=white)](https://tauri.app)\n[![NSIS](https://img.shields.io/badge/NSIS-installer-0095D9?style=flat-square)](https://nsis.sourceforge.io)\n\n  <br/>\n  <b>Say:</b> <i>\"Load Daft Punk on deck 2, sync it, cue the drop, then fade in on the next beat.\"</i>\n  <br/>\n  <b>It happens.</b>\n  <br/><br/>\n\n  <img src=\"docs/screenshots/cockpit.png\" alt=\"Mixx-DJ-MCP Cockpit\" width=\"800\"/>\n\n  <br/>\n  <sub>\n  <a href=\"docs/FIRST-RUN.md\">First Run</a> ·\n  <a href=\"docs/INSTALL.md\">Install</a> ·\n  <a href=\"docs/TOOLS.md\">Tools</a> ·\n  <a href=\"docs/STATUS.md\">Status</a> ·\n  <a href=\"docs/ARCHITECTURE.md\">Architecture</a> ·\n  <a href=\"docs/MIXXX_VIDEO.md\">Video</a> ·\n  <a href=\"docs/ORCHESTRATOR.md\">AV Rig</a> ·\n  <a href=\"docs/NDI.md\">NDI</a> ·\n  <a href=\"docs/NDI-TARGETS.md\">NDI Targets</a> ·\n  <a href=\"docs/NOOB_GUIDE.md\">Beginner Guide</a> ·\n  <a href=\"docs/AI_TRANSITIONS.md\">AI Transitions</a>\n  </sub>\n</div>\n\n<br/>\n\n## One command to start\n\n```bash\nuv sync && uv run uvicorn mixx_dj_mcp.server:app --port 11116\n```\n\nConfigure Mixxx OSC once (one minute): **Preferences > MIDI/OSC > Enable OSC**, set out `11118`, in `11119`, send to `127.0.0.1`, restart. Done.\n\nYour AI assistant (Claude, Cursor, opencode) can now control your decks.\n\n## What it does\n\n| You say | The AI does |\n|---------|-------------|\n| \"Play deck 2\" | `mixx_deck(operation=\"play_pause\", deck=2)` — OSC to Mixxx |\n| \"Find some 128 BPM tech house\" | `mixx_library(operation=\"search\", query=\"tech house\")` |\n| \"Add reverb to the outgoing track\" | `mixx_effects(operation=\"chain_load\", rack=1, effect=\"Reverb\")` |\n| \"Plan a 30-min drum & bass set\" | `mixx_ai_set(operation=\"plan\", style=\"drum and bass\")` |\n| \"Record this set\" | `mixx_recording(operation=\"start\")` |\n| \"Analyse this track's key\" | `mixx_analyze(operation=\"track\", path=\"C:/Music/track.mp3\")` |\n| \"Show me my most-played tracks\" | `mixx_history(operation=\"profile\")` |\n| \"Transition with an echo out\" | `mixx_transition(operation=\"apply\", effect=\"echo_out\")` |\n\n## Tools at a glance\n\n| Tool | What it controls |\n|------|-----------------|\n| `mixx_deck` | Play/pause, load, cue, loops, sync, rate, scratch, hotcues, quantize, keylock — plus video |\n| `mixx_library` | Search, browse crates/playlists, BPM/key metadata |\n| `mixx_effects` | Effect chains, parameters, quick effects, super knob |\n| `mixx_mixer` | Crossfader, EQ, gain, headphone cue, talkover, mic |\n| `mixx_analyze` | BPM detection, musical key (Krumhansl-Schmuckler), energy, cue suggestions |\n| `mixx_stems` | Demucs stem separation, sampler loading, stem-aware mixing |\n| `mixx_transition` | AI-suggested transitions, 8 effect types, auto-crossfader |\n| `mixx_ai_set` | **Autonomous DJ** — plan sets, perform transitions, review |\n| `mixx_recording` | Record, replay, and export DJ sets as OSC streams |\n| `mixx_history` | Play history, style profile, track suggestions |\n| `mixx_crate` | LLM-generated smart crates by BPM/key/genre |\n| `mixx_set` | Harmonic mixing sequences, energy curve planning |\n| `mixx_skin` | List, apply, create video skins, AI palette generation |\n| `mixx_vinyl` | OCR catalog, AI gig picker, Plex crossref |\n| `mixx_controller` | USB auto-detect, install mappings |\n| `mixx_daw` | Export stems to DaVinci Resolve, Reaper |\n| Prefab cards | `show_deck/mixer/library_status_card` — rich in-chat UI |\n\n## Quick links\n\n| For... | Read |\n|--------|------|\n| **Installing** the server, webapp, NSIS installer, or MCPB | [`docs/INSTALL.md`](docs/INSTALL.md) |\n| **Status & backlog** | [`docs/STATUS.md`](docs/STATUS.md) · [`docs/TODO.md`](docs/TODO.md) |\n| **Full tool reference** with parameters, returns, and examples | [`docs/TOOLS.md`](docs/TOOLS.md) |\n| **Using video** — requires the mixxxxx fork of Mixxx | [`docs/MIXXX_VIDEO.md`](docs/MIXXX_VIDEO.md) |\n| **AV orchestrator** (mixxxxx hub, NDI, Resolume, OBS) | [`docs/ORCHESTRATOR.md`](docs/ORCHESTRATOR.md) · webapp **Help → AV Rig** |\n| **NDI** (network video from mixxxxx) | [`docs/NDI.md`](docs/NDI.md) · [`docs/NDI-TARGETS.md`](docs/NDI-TARGETS.md) · webapp **Help → NDI** |\n| **Project status & backlog** | [`docs/STATUS.md`](docs/STATUS.md) · [`docs/TODO.md`](docs/TODO.md) |\n| **AI-powered transitions** between decks | [`docs/AI_TRANSITIONS.md`](docs/AI_TRANSITIONS.md) |\n| **Architecture** — how the OSC bridge, REST API, and webapp work | [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) |\n| **Beginner's guide** to DJing with Mixxx | [`docs/NOOB_GUIDE.md`](docs/NOOB_GUIDE.md) |\n| **Comparing** Mixxx to other DJ software | [`docs/DJ_LANDSCAPE.md`](docs/DJ_LANDSCAPE.md) |\n| **Algoriddim djay** feature parity | [`docs/ALGORIDDIM_COMPARISON.md`](docs/ALGORIDDIM_COMPARISON.md) |\n| **Mixxx OSC setup** and address reference | [`bridge/README.md`](bridge/README.md) |\n\n## Video DJing\n\nMixx-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.\n\n[mixxxxx on GitHub](https://github.com/sandraschi/mixxxxx) &nbsp;·&nbsp; [`docs/MIXXX_VIDEO.md`](docs/MIXXX_VIDEO.md)\n\n## Ports\n\n| Port | What |\n|------|------|\n| **11116** | Backend REST API + MCP transport |\n| **11117** | React webapp (Vite) |\n| **11118** | OSC feedback from Mixxx |\n| **11119** | OSC commands to Mixxx |\n\n## Fleet integrations\n\nMixx-DJ-MCP is a **Fleet Audio Hub** — it connects to other MCP servers for a unified DJ ecosystem:\n\n| Server | Integration |\n|--------|-------------|\n| `plex-mcp` | Cross-reference vinyl with digital library |\n| `songgeneration-mcp` | AI music generation loaded direct to decks |\n| `sfx-mcp` | Sound effects triggered during live sets |\n| `vfx-mcp` | Real-time video effects on video output |\n| `stems-mcp` | External stem separation engine |\n| `davinci-resolve-mcp` | Export stems to Fairlight for post-production |\n| `reaper-mcp` | Export stems to Reaper DAW |\n| `inkscape-mcp` | AI skin colour palette generation |\n| `speech-mcp` | Voice-controlled DJing (\"Hey Mixxx, load deck 2...\") |\n\n## License\n\nMIT — Sandra Schipal\n\n_Vinyl not included. Mixxx not included. Bad music taste is your own._",
  "bytes": 7159,
  "sha": "9e39ea8994769c021a53d4644bb40dea4ecba717fd2b8a148465437fbb3948fd",
  "repo_slug": "sandraschi/mixx-dj-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_sandraschi_mixx_dj_mcp_c7e6cd85/readme"
}