mcp-daw
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
mcp-daw: an MCP music sequencer for AI agents
mcp-daw lets an AI agent make music from loops and one-shot samples over the Model Context Protocol (MCP). The agent edits a plain JSON song file (tempo, key, swing, step patterns, loop placements), and a renderer turns it into a 44.1 kHz stereo WAV/MP3. Samples are indexed with their licence, and the renderer warns if a song uses anything that isn't safe to release.
Example: songs/lofi_full.json (built by build_lofi.py) is a 96-second lo-fi track at 80 BPM.
Core functions (wrapped by the MCP server below):
MCP tool | function |
|
|
|
|
|
|
|
|
|
|
|
|
Setup
python -m venv .venv && . .venv/bin/activate # Windows: .venv\Scripts\activate
pip install -r requirements.txt
python scan.py # index samples/ -> library.db
python render_song.py songs/demo.json out/demo.wav --mp3
pytest -qRelated MCP server: DJ-MCP
Windows setup
cd mcp-daw
python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt
python scan.py
pytest -qMCP server
mcp_server.py is a FastMCP stdio server (requires mcp<2; mcp 2.x renamed FastMCP).
Project root = MCP_DAW_ROOT env var, or the folder containing mcp_server.py.
Songs live in songs/<name>.json, renders in out/<name>.wav|.mp3; all paths in tool I/O are relative to the root.
If library.db is missing it is built on first use.
Tools: search_samples, list_categories, new_song(name,bpm,key,bars,swing), add_pattern_track,
add_loop_track, set_mix(song,track,gain_db,pan), describe_song, render(song, mp3=True), list_songs,
master_audio, apply_arrangement_dynamics, comfy_m2m, comfy_vocal_pass, check_lyrics (see below).
Example client config (Claude Desktop / Cursor / LM Studio style). Use the venv's python so deps are found:
{
"mcpServers": {
"mcp_daw": {
"command": "C:\\path\\to\\mcp-daw\\.venv\\Scripts\\python.exe",
"args": ["C:\\path\\to\\mcp-daw\\mcp_server.py"],
"env": { "MCP_DAW_ROOT": "C:\\path\\to\\mcp-daw" }
}
}
}("command": "python" also works if that python has the requirements installed.)
Song file
{"bpm": 94, "key": "C minor", "bars": 4, "swing": 0.35,
"sections": [{"name": "groove", "start_bar": 0, "bars": 4}],
"tracks": [
{"name": "kick", "type": "pattern", "sample": "uzu-drumkit/bd/11_bd_mot4i.wav",
"steps": [1,0,0,0, 0,0,0,0.6, 0,0,1,0, 0,0,0,0], "gain_db": 0, "pan": 0},
{"name": "bass", "type": "pattern", "sample": "karoryfer.meatbass/Samples/pizz/c2_vl4_rr1.wav",
"steps": [...16 velocities...], "pitches": [...16 semitone shifts...]},
{"name": "break", "type": "loop", "sample": "uzu-drumkit/brk/10_break_amen_pprocessed.wav",
"loop_bars": 1, "start_bars": [2, 3], "gain_db": -10}
]}steps: 16 sixteenth-notes per bar, value = velocity (0 = off). Optionalbars: [0,2]limits which bars play.swing0–1 delays odd 16ths by up to half a step.Loops are time-stretched (librosa) to exactly
loop_barsat the song BPM.Sample paths are relative to
samples/. Mix is normalised to −1 dBFS; tails are cut at the song end.
Samples (all release-safe)
folder | licence | source |
| Unlicense | github.com/tidalcycles/uzu-drumkit |
| CC0 | github.com/sfzinstruments/karoryfer.swirly-drums (trimmed: dry mics, rr1, 4 velocity layers) |
| CC0 | github.com/sfzinstruments/karoryfer.meatbass (pizz only, rr1) |
Licence is read from each source folder's LICENSE file and stored per sample. The renderer warns on anything
not in library.RELEASE_SAFE (CC0, Unlicense, CC-BY; CC-BY gets a "credit the author" note).
Unlicensed sets such as Dirt-Samples should go in their own folder; they'll index as unknown and trigger warnings.
Mastering and arrangement dynamics
mcp_daw/master.py normalises to a loudness target with pyloudnorm (ITU-R BS.1770) and then limits the
true peak. The limiter is ffmpeg's alimiter run at 4x the sample rate (a numpy look-ahead limiter is used if
ffmpeg is missing). The output is re-measured at 4x oversampling and the ceiling is tightened until the true
peak really is at or below the target.
preset | LUFS | ceiling |
| -14 | -1 dBTP |
| -13 | -1 dBTP |
| -12.5 | -1 dBTP |
| -12 | -1 dBTP |
| -11.5 | -1 dBTP |
| -11 | -1 dBTP |
| -10.5 | -1 dBTP |
mcp_daw/dynamics.py uses the song's bpm and sections to shape a mix (or an AI re-take of it):
finds the beat phase from onsets, then ducks on every beat of
build(second half) anddrop/chorussections. The signal is split at 150 Hz (zero-phase) so the low band ducks harder than the rest.section contrast:
intro/break/outroare cut relative to the loudest drop; builds ramp up; gain changes are smoothed over ~25 ms at bar lines.pre-drop sweep: the 4 bars before each drop blend towards a 400 Hz low-cut.
Presets: subtle (3 dB / 1.2 dB duck, ~6 dB drop-vs-break after mastering) and strong (5 dB / 2 dB, ~8 dB).
from mcp_daw import dynamics, master
out, info = dynamics.apply_dynamics(audio, sr, song["bpm"], song["sections"], "strong")
out, report = master.master(out, sr, "edm") # report: lufs, true_peak_dbtpComfyUI / ACE-Step (optional)
Set COMFYUI_URL in the environment or in a .env file (see .env.example). The workflows are built in
code (mcp_daw/comfy.py); ComfyUI needs the ACE-Step checkpoints ace_step_v1_3.5b.safetensors and
ace_step_1.5_turbo_aio.safetensors.
comfy_m2m(path, tags, lyrics, denoise): ACE-Step v1 music-to-music. ~0.3-0.5 keeps the arrangement, 0.7 restyles it.comfy_vocal_pass(song, path, lyrics, tags): ACE-Step 1.5 turbo over an instrumental, conditioned on the song's BPM, key and the file's duration (16 steps, dpmpp_2m, CFG 1.4). Use[verse]/[chorus]/[instrumental]tags in the lyrics. Don't name real artists in tags.
Generated audio inherits the licences of whatever you feed in. Keep renders of non-release-safe samples private.
Lyric intelligibility check (optional)
pip install -r requirements-asr.txt (faster-whisper), then check_lyrics(path, lyrics, start, duration)
returns precision (share of heard words that are in the lyrics), recall (share of the lyric vocabulary
heard) and the transcript. It's a rough guide for comparing takes, not a score of the singing.
Known limits
Categories come from file/folder names first (kick, snare, hat, bass, lead, pad, vocal, chord/stab, arp, pluck, riser, fx, ...), then a simple fallback: noisy ->
fx, rising envelope ->riser, sustained ->pad, otherwise spectral centroid (low/mid/high). Files over 60 s getstem = 1(stems / full bounces).Loop detection = name hint (loop/brk/break) or ≥3 s with ≥8 onsets; Swirly's snare rolls/stirs count as loops.
Pitch shifting is sampler-style resampling (pitch and length change together).
License
Code: MIT, (c) 2026 Stephen Phillips. See LICENSE.
Bundled samples keep their own licences (Unlicense / CC0); see each folder under samples/.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Generate full songs with vocals, instrumentals and sound effects from text. One server for Suno, Google Lyria, Mureka, MiniMax, ACE-Step, YuE and ElevenLabs. Your agent can quote the credit cost before generating, start a song, wait for it to finish and return download links. Sign in with OAuth; optional daily credit caps; retries never charge twice.
Read and edit DAW projects as an agent, save native Logic projects, convert projects between DAWs
Make AI Tracks, loops and sound effects, split stems, build drum kits and master songs.
Music industry tools for AI agents: artist research, catalogs, release plans and content.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables coding agents to compose, edit and run multi-agent pipelines represented as songs, where channels are agents, notes are agent calls, and mixer buses carry each agent's output to the next. Lets agents create and modify arrangements, validate and render projects headlessly, play them back live in a studio window, and export the result as WAV or MP3, with every change undoable and cached takes replayed for free.43 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to perform deterministic, sample-accurate music production, DJ mixing, audio editing, stem separation, and loudness mastering through non-destructive timeline operations and structured MCP tools.Mozilla Public 2.0
- AlicenseNot gradedqualityBmaintenanceEnables Claude to turn a JSON song spec into a real, editable FL Studio project plus a matching MIDI file, then render it headless, master to a loudness target, and analyze the audio for loudness, tonal balance and section-level mix problems so the model can iterate without hearing.3MIT
- FlicenseNot gradedqualityBmaintenanceEnables agents to read, patch, and render DAW projects (REAPER, FL Studio, .rpp/.dawproject) and to measure WAV audio metrics such as peak, RMS, LUFS, and stereo width. It closes the loop by applying patches, rendering before/after audio, and scoring the results against an intent so music-production models can be trained and verified.-