Mixx Dj Mcp

io.github.sandraschi由 GitHub 账号 sandraschi 发布v0.2.0更新于 Oct 26, 2026

FastMCP server for Mixxx DJ software control via OSC protocol

已验证STDIO仅桌面媒体与设计AI 与机器学习

概览

AI 生成的概览

通过 OSC 控制 Mixxx DJ 软件,让助手在对话中操作唱盘、曲库、效果、混音台、分轨、过渡和视频。

可以做什么
  • 播放、加载、打点、循环、同步和搓盘,并支持视频输出
  • 搜索和浏览曲库、曲箱、播放列表及 BPM/调性元数据
  • 管理效果链、混音台电平、交叉推子、EQ 和麦克风
  • 分析曲目的 BPM、调性与能量,并分离分轨
  • 规划演出、建议并应用过渡、录制和导出演出
  • 在对话中显示唱盘、混音台和曲库状态卡片
适用场景
适合使用 Mixxx 打碟并希望助手代为操作软件的场景:加载与同步曲目、检索曲库、调整效果与混音、规划和声编排的演出,或录制一场演出。
运行要求
以本地 Python 项目运行,使用 uv 启动(uv sync 与 uv run uvicorn,端口 11116)。需安装 Mixxx 并在首选项中启用 OSC,向 127.0.0.1 的 11118 与 11119 端口收发。视频功能需要另行安装修改版 Mixxx。
安装前请注意
它会向 DJ 软件发送实时控制指令,助手操作可能在演出中改变播放、混音电平和录音。分轨与曲目分析会按路径处理本地音频文件。可选的配套服务器会带来更多集成,需单独安装。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Mixx Dj Mcp,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

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.

来源:README.md,提交 1b97174

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

1
  1. v0.2.0最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分