Sobre el proyecto

Mixx-DJ-MCP es un servidor MCP (Model Context Protocol) que otorga a los asistentes de IA control directo sobre la aplicación de DJ de código abierto Mixxx. Se describe como "control de DJ nativo de IA para Mixxx", y expone más de 80 operaciones en decks, biblioteca, efectos, mezclador, stems, transiciones y vídeo. Cómo funciona: el servidor conecta las llamadas a herramientas MCP con Mixxx a través de OSC. Mixxx debe configurarse una vez (Preferences > MIDI/OSC > Enable OSC, salida 11118, entrada 11119, enviar a 127.0.0.1). Después de eso, asistentes como Claude, Cursor u opencode pueden emitir comandos en lenguaje natural que se asignan a llamadas de herramientas, por ejemplo cargar una pista en un deck, sincronizar, hacer cue o hacer fade in en el siguiente beat. El arranque es un único comando usando uv: sincronizar dependencias y ejecutar el servidor uvicorn en el puerto 11116. Los puertos están documentados: 11116 API REST backend + transporte MCP, 11117 webapp React (Vite), 11118 retroalimentación OSC desde Mixxx, 11119 comandos OSC hacia Mixxx. Superficie de herramientas (según el README): mixx_deck (play/pause, load, cue, loops, sync, rate, scratch, hotcues, quantize, keylock, además de vídeo), mixx_library (búsqueda, navegación por crates/playlists, metadatos de BPM/key), mixx_effects (cadenas, parámetros, efectos rápidos, super knob), mixx_mixer (crossfader, EQ, gain, cue de auriculares, talkover, mic), mixx_analyze (detección de BPM, tonalidad musical mediante Krumhansl-Schmuckler, energía, sugerencias de cue), mixx_stems (separación de stems con Demucs, carga en sampler, mezcla consciente de stems), mixx_transition (transiciones sugeridas por IA, ocho tipos de efectos, crossfader automático), mixx_ai_set (planificación autónoma de sets, ejecución de transiciones, revisión), mixx_recording (grabar, reproducir, exportar sets como flujos OSC), mixx_history (historial de reproducción, perfil de estilo, sugerencias), mixx_crate (crates inteligentes generados por LLM por BPM/key/género), mixx_set (secuencias de mezcla armónica, planificación de curva de energía), mixx_skin (listar/aplicar/crear skins de vídeo, generación de paletas por IA), mixx_vinyl (catálogo OCR, selector de gigs por IA, referencias cruzadas con Plex), mixx_controller (detección automática por USB, instalación de mapeos), mixx_daw (exportar stems a DaVinci Resolve, Reaper), y tarjetas prefab para UI enriquecida en el chat (estado de deck/mezclador/biblioteca). El DJing de vídeo es compatible mediante el fork separado "mixxxxx" de Mixxx, que añade reproducción de vídeo con FFmpeg, widgets de vídeo por deck y salida a proyector en pantalla completa junto al motor de audio. La documentación relacionada cubre un orquestador AV (NDI, Resolume, OBS), destinos NDI, transiciones por IA, arquitectura, una guía para principiantes y comparaciones con otro software de DJ. Más allá del servidor MCP, el proyecto incluye una webapp React 19 + Tauri 2.0 y un instalador NSIS. También describe integraciones de "Fleet Audio Hub" con otros servidores MCP: plex-mcp, songgeneration-mcp, sfx-mcp, vfx-mcp, stems-mcp, davinci-resolve-mcp, reaper-mcp, inkscape-mcp y speech-mcp (DJing controlado por voz). Licencia MIT (Sandra Schipal). Mixxx y vinyl no están incluidos.