mixx-dj-mcp

一条命令即可启动

uv sync && uv run uvicorn mixx_dj_mcp.server:app --port 11116

只需配置一次 Mixxx OSC（一分钟）：Preferences > MIDI/OSC > Enable OSC，将 out 设为 11118，in 设为 11119，发送目标设为 127.0.0.1，然后重启。完成。

你的 AI 助手（Claude、Cursor、opencode）现在可以控制你的唱盘了。

功能介绍

你说	AI 会执行
“播放 2 号唱盘”	mixx_deck(operation="play_pause", deck=2) -- 通过 OSC 发送给 Mixxx
“找一些 128 BPM 的 Tech House”	mixx_library(operation="search", query="tech house")
“给即将淡出的曲目加上混响”	mixx_effects(operation="chain_load", rack=1, effect="Reverb")
“规划一场 30 分钟的 Drum & Bass 演出”	mixx_ai_set(operation="plan", style="drum and bass")
“录下这场演出”	mixx_recording(operation="start")
“分析这首曲子的调性”	mixx_analyze(operation="track", path="C:/Music/track.mp3")
“显示我播放次数最多的曲目”	mixx_history(operation="profile")
“用回声淡出完成转场”	mixx_transition(operation="apply", effect="echo_out")

工具一览

工具	控制内容
mixx_deck	播放/暂停、加载、预备、循环、同步、速率、搓盘、热切入点、量化、锁定调性——以及视频
mixx_library	搜索、浏览唱片箱/播放列表、BPM/调性元数据
mixx_effects	效果链、参数、快速效果、超级旋钮
mixx_mixer	交叉推子、均衡器、增益、耳机监听、通话优先、麦克风
mixx_analyze	BPM 检测、音乐调性（Krumhansl-Schmuckler）、能量、切入点建议
mixx_stems	Demucs 分轨、采样器加载、分轨感知混音
mixx_transition	AI 推荐的过渡、8 种效果类型、自动交叉推子
mixx_ai_set	自主 DJ——规划曲目集、执行过渡、回顾
mixx_recording	将 DJ 曲目集录制、重放并导出为 OSC 流
mixx_history	播放历史、风格档案、曲目推荐
mixx_crate	按 BPM/调性/流派由大模型生成智能唱片箱
mixx_set	和声混音序列、能量曲线规划
mixx_skin	列出、应用、创建视频皮肤，AI 调色板生成
mixx_vinyl	OCR 目录、AI 演出选曲、Plex 交叉比对
mixx_controller	USB 自动检测、安装映射
mixx_daw	将分轨导出到 DaVinci Resolve、Reaper
预制卡片	show_deck/mixer/library_status_card——丰富的聊天内 UI

快速链接

适用于……	阅读
安装服务、Web 应用、NSIS 安装程序或 MCPB	docs/INSTALL.md
状态与待办事项	docs/STATUS.md · docs/TODO.md
完整的工具参考，包括参数、返回值和示例	docs/TOOLS.md
使用视频——需要 Mixxx 的 mixxxxx 分支	docs/MIXXX_VIDEO.md
AV 编排器（mixxxxx hub、NDI、Resolume、OBS）	docs/ORCHESTRATOR.md · Web 应用 帮助 → AV Rig
NDI（来自 mixxxxx 的网络视频）	docs/NDI.md · docs/NDI-TARGETS.md · Web 应用 帮助 → NDI
项目状态与待办事项	docs/STATUS.md · docs/TODO.md
牌组之间的 AI 过渡	docs/AI_TRANSITIONS.md
架构——OSC 桥接、REST API 和 Web 应用的工作方式	docs/ARCHITECTURE.md
Mixxx DJ 入门指南	docs/NOOB_GUIDE.md
比较Mixxx 与其他 DJ 软件	docs/DJ_LANDSCAPE.md
Algoriddim djay 功能对等情况	docs/ALGORIDDIM_COMPARISON.md
Mixxx OSC 设置和地址参考	bridge/README.md

视频 DJ

Mixx-DJ-MCP 支持 mixxxxx 视频分支——这是一个经过修改的 Mixxx 构建版本，增加了 FFmpeg 视频播放、每个牌组的视频小组件，以及全屏投影仪输出，同时保留标准音频引擎。

mixxxxx 在 GitHub 上  ·  docs/MIXXX_VIDEO.md

端口

端口	用途
11116	后端 REST API + MCP 传输
11117	React Web 应用（Vite）
11118	来自 Mixxx 的 OSC 反馈
11119	发往 Mixxx 的 OSC 命令

Fleet 集成

Mixx-DJ-MCP 是一个 Fleet Audio Hub——它连接到其他 MCP 服务，构建统一的 DJ 生态系统：

服务	集成
plex-mcp	将黑胶唱片与数字音乐库交叉比对
songgeneration-mcp	AI 生成的音乐直接加载到牌组
sfx-mcp	在现场曲目集中触发音效
vfx-mcp	对视频输出应用实时视频效果
stems-mcp	外部分轨引擎
davinci-resolve-mcp	将分轨导出到 Fairlight 进行后期制作
reaper-mcp	将分轨导出到 Reaper DAW
inkscape-mcp	AI 皮肤配色方案生成

Fleet 互联（配套服务）

mixx-dj-mcp 可完全独立运行。你也可以选择将它与 sandraschi Fleet 中的配套服务连接，以解锁扩展功能：

配套服务	解锁的功能	状态	设置
resolume-mcp	ndi-vj-routing、osc-clip-sync、live-projection-mapping	可选	安装指南
resonite-mcp	virtual-world-stage、nekomimi-avatar-dance、osc-bpm-telemetry	可选	安装指南

独立运行的配套服务：Fleet 配套服务可独立运行。安装配套服务不会触发传递依赖链。

许可证

MIT —— Sandra Schipal

不附赠黑胶唱片。不附赠 Mixxx。糟糕的音乐品味由你自己负责。