audio-studio-mcp

English | 简体中文 | 日本語

🎧 Listen to samples · Quick start · Tools · FAQ · ⭐ Star

Audio Studio MCP gives Claude Code, Claude Desktop, Cursor and any other MCP client a sound studio that runs on your own Mac. Ask for background music or a sound effect in plain language; the model generates it locally with Stable Audio 3. Then it can loop it, normalize the loudness and export it for your game engine or video editor. There is no cloud service and no API key, and generating doesn't cost anything.

✨ Highlights

• Reproducible: every file gets a .json sidecar with its prompt, seed and settings.
• Prompting built in: the server teaches the client the official Stable Audio 3 prompt format, so a request like "make it sound like a creaky door" becomes a prompt the model understands.
• Same output as upstream: for the same seed, results are bit-for-bit identical to the official sa3 CLI.

🎧 Hear it

All of these were generated by this server on an M1 Mac and were not edited by hand. Open the sample page →

MP3s are in docs/samples/, with prompts and seeds in samples.json.

🧭 How it works

flowchart LR
    U["You<br/>“make a cozy cafe BGM”"] --> C["Claude Code · Desktop<br/>Cursor · any MCP client"]
    C -- "MCP" --> S["audio-studio-mcp<br/>generate · edit · process"]
    S --> M["Stable Audio 3<br/>MLX on Apple Silicon"]
    M --> F["WAV / OGG / FLAC + .json<br/>ready for game & video"]

🚀 Quick start

Requirements:

• Apple Silicon Mac (M1 or later), 16 GB RAM recommended
• About 6 GB of disk for the model
• git and ffmpeg (brew install ffmpeg)

git clone https://github.com/kanaworksai-hue/audio-studio-mcp.git
cd audio-studio-mcp
./install.sh

The installer sets up uv if needed, clones the official Stable Audio 3 runtime into vendor/ at a tested commit, creates .venv/, and downloads the medium model (1.4B, ~5.9 GB) from Hugging Face. It finishes by printing the exact command to register the server:

claude mcp add --scope user audio-studio -- /path/to/audio-studio-mcp/.venv/bin/audio-studio-mcp

Add this to claude_desktop_config.json, .cursor/mcp.json or your client's MCP config:

{
  "mcpServers": {
    "audio-studio": {
      "command": "/path/to/audio-studio-mcp/.venv/bin/audio-studio-mcp"
    }
  }
}

Downloads are anonymous. Logging in with hf auth login raises Hugging Face's rate limit.

[!TIP] Let your agent install it. Paste this into Claude Code: "Install https://github.com/kanaworksai-hue/audio-studio-mcp by following its README, then register it as an MCP server."

Then just ask:

• "Make a 60-second lo-fi BGM loop at 85 BPM for a cafe scene, give me 3 candidates."
• "I need a heavy wooden door slamming in a stone hallway. Export it as OGG for Godot."
• "Extend this track to 90 seconds and normalize it to −16 LUFS."

🧰 Tools

• audio_type: music / instrument / sfx / raw. The server adds the prefix the model was trained with (TrackType: Music, VocalType: Instrumental, …). Without the SFX prefix, sound effects often come out as music.
• variations: 1–4 candidates with seeds seed, seed+1, …. Use seed: -1 or leave it out for a random seed.
• sound_source / sound_action / sound_material / sound_space: describe a sound effect by what makes it, how it evolves, its texture and the space it is in.
• peak_ceiling_db (default −1): a safety ceiling. Louder peaks are turned down and quieter audio is never boosted. Use process_audio to normalize.
• process_audio normalization: peak is common for SFX. loudness normalizes to a target LUFS: −14 for streaming/video, −16 for game BGM, −23 for broadcast.

Generated files are 44.1 kHz 24-bit stereo WAV, written to outputs/ in this folder. Each one has a <name>.json next to it. Processed files keep the original generation info under source.

⚙️ Configuration