mixx-dj-mcp

1 つのコマンドで起動

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

Mixxx の OSC を一度設定します（1 分）：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) -- Mixxx に OSC を送信
「128 BPM のテックハウスを探して」	mixx_library(operation="search", query="tech house")
「再生中の曲にリバーブを追加して」	mixx_effects(operation="chain_load", rack=1, effect="Reverb")
「30 分のドラムンベースのセットを計画して」	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	クロスフェーダー、EQ、ゲイン、ヘッドホンキュー、トークオーバー、マイク
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／キー／ジャンルに基づく LLM 生成のスマートクレート
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

クイックリンク

内容	参照先
サーバー、ウェブアプリ、NSIS インストーラー、または MCPB のインストール	docs/INSTALL.md
ステータスとバックログ	docs/STATUS.md · docs/TODO.md
パラメーター、戻り値、例を含むツールの完全なリファレンス	docs/TOOLS.md
ビデオの使用方法 -- mixxxxx 版 Mixxx が必要です	docs/MIXXX_VIDEO.md
AV オーケストレーター（mixxxxx ハブ、NDI、Resolume、OBS）	docs/ORCHESTRATOR.md · ウェブアプリの ヘルプ → AV リグ
NDI（mixxxxx からのネットワークビデオ）	docs/NDI.md · docs/NDI-TARGETS.md · ウェブアプリの ヘルプ → NDI
プロジェクトのステータスとバックログ	docs/STATUS.md · docs/TODO.md
デッキ間のAI 搭載トランジション	docs/AI_TRANSITIONS.md
OSC ブリッジ、REST API、ウェブアプリの仕組みを解説するアーキテクチャ	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 ビデオ版に対応しています。これは、標準のオーディオエンジンに加えて、FFmpeg によるビデオ再生、デッキごとのビデオウィジェット、全画面プロジェクター出力を追加した Mixxx の改変ビルドです。

GitHub の mixxxxx  ·  docs/MIXXX_VIDEO.md

ポート

ポート	内容
11116	バックエンドの REST API + MCP トランスポート
11117	React ウェブアプリ（Vite）
11118	Mixxx からの OSC フィードバック
11119	Mixxx への OSC コマンド

フリート連携

Mixx-DJ-MCP はフリートオーディオハブとして、ほかの 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 フリートのコンパニオンサーバーと接続できます。

コンパニオンサーバー	利用可能になる機能	状態	セットアップ
resolume-mcp	ndi-vj-routing、osc-clip-sync、live-projection-mapping	オプション	インストールガイド
resonite-mcp	virtual-world-stage、nekomimi-avatar-dance、osc-bpm-telemetry	オプション	インストールガイド

自己完結型のコンパニオン：フリートのコンパニオンは独立して動作します。コンパニオンをインストールしても、依存関係が連鎖的に追加されることはありません。

ライセンス

MIT -- Sandra Schipal

レコードは付属しません。Mixxx は付属しません。音楽の趣味が悪いのはご自身の責任です。