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 分