프로젝트 소개

Mixx-DJ-MCP는 AI 어시스턴트가 오픈소스 Mixxx DJ 애플리케이션을 직접 제어할 수 있게 해주는 MCP(Model Context Protocol) 서버입니다. "Mixxx를 위한 AI 네이티브 DJ 제어"로 설명되며, 덱, 라이브러리, 이펙트, 믹서, 스템, 트랜지션, 비디오 전반에 걸쳐 80개 이상의 작업을 노출합니다. 작동 방식: 이 서버는 MCP 도구 호출을 OSC를 통해 Mixxx로 브리지합니다. Mixxx는 한 번 구성해야 합니다(Preferences > MIDI/OSC > Enable OSC, out 11118, in 11119, send to 127.0.0.1). 그 후 Claude, Cursor, opencode 같은 어시스턴트가 도구 호출로 매핑되는 자연어 명령을 내릴 수 있습니다. 예를 들어 덱에 트랙 로드, 싱크, 큐잉, 또는 다음 비트에 페이드 인 등입니다. 시작은 uv를 사용하는 단일 명령입니다. 의존성을 동기화하고 uvicorn 서버를 포트 11116에서 실행합니다. 포트는 문서화되어 있습니다. 11116 백엔드 REST API + MCP 전송, 11117 React 웹앱(Vite), 11118 Mixxx로부터의 OSC 피드백, 11119 Mixxx로의 OSC 명령. 도구 표면(README에 나열된 대로): mixx_deck(재생/일시정지, 로드, 큐, 루프, 싱크, 레이트, 스크래치, 핫큐, 퀀타이즈, 키락, 그리고 비디오), mixx_library(검색, 크레이트/플레이리스트 탐색, BPM/키 메타데이터), mixx_effects(체인, 파라미터, 퀵 이펙트, 슈퍼 노브), mixx_mixer(크로스페이더, EQ, 게인, 헤드폰 큐, 토크오버, 마이크), mixx_analyze(BPM 감지, Krumhansl-Schmuckler를 통한 음악 키, 에너지, 큐 제안), mixx_stems(Demucs 스템 분리, 샘플러 로딩, 스템 인식 믹싱), mixx_transition(AI 제안 트랜지션, 8가지 이펙트 유형, 자동 크로스페이더), mixx_ai_set(자율 세트 기획, 트랜지션 수행, 리뷰), mixx_recording(녹음, 리플레이, 세트를 OSC 스트림으로 내보내기), mixx_history(재생 기록, 스타일 프로필, 제안), mixx_crate(BPM/키/장르별 LLM 생성 스마트 크레이트), mixx_set(하모닉 믹싱 시퀀스, 에너지 곡선 기획), mixx_skin(비디오 스킨 나열/적용/생성, AI 팔레트 생성), mixx_vinyl(OCR 카탈로그, AI 공연 선택, Plex 상호 참조), mixx_controller(USB 자동 감지, 매핑 설치), mixx_daw(스템을 DaVinci Resolve, Reaper로 내보내기), 그리고 풍부한 인챗 UI용 프리팹 카드(덱/믹서/라이브러리 상태). 비디오 DJing은 Mixxx의 별도 "mixxxxx" 포크를 통해 지원되며, 이 포크는 오디오 엔진과 함께 FFmpeg 비디오 재생, 덱별 비디오 위젯, 전체 화면 프로젝터 출력을 추가합니다. 관련 문서는 AV 오케스트레이터(NDI, Resolume, OBS), NDI 타깃, AI 트랜지션, 아키텍처, 초보자 가이드, 다른 DJ 소프트웨어와의 비교를 다룹니다. MCP 서버 외에도 이 프로젝트는 React 19 + Tauri 2.0 웹앱과 NSIS 설치 프로그램을 제공합니다. 또한 다른 MCP 서버와의 "Fleet Audio Hub" 통합을 설명합니다: plex-mcp, songgeneration-mcp, sfx-mcp, vfx-mcp, stems-mcp, davinci-resolve-mcp, reaper-mcp, inkscape-mcp, speech-mcp(음성 제어 DJing). MIT 라이선스(Sandra Schipal). Mixxx와 바이닐은 포함되지 않습니다.