kanaworksai-hue / audio-studio-mcp

A KanaWorks_AI project 
**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 or Windows PC. 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.
 A real session, shortened. Claude picked a loop length of exactly 11 bars so the beat stays in time when it repeats. 
## ✨ Highlights
 Generate BGM, instrument loops and sound effects from one sentence, 1–4 candidates per call 
 Edit Re-style a whole clip, regenerate a time range, or extend a track 
 Finish Seamless loops, fades, loudness (LUFS), 48 kHz WAV / OGG / FLAC 
 Local Runs on Apple Silicon (MLX) or an NVIDIA GPU (PyTorch). Nothing is uploaded 
- **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:** on a Mac, results for the same seed are bit-for-bit identical to the official `sa3` CLI. On Windows it calls the official Stable Audio 3 PyTorch API.
## 🎧 Hear it
All of these were generated by this server on an M1 Mac and were not edited by hand. **Open the sample page →**
| | Sample | Prompt |
|---|---|---|
| | **Lo-fi cafe** music · 30 s · 85 BPM | Lo-fi hip-hop chill track with mellow electric piano, soft vinyl crackle, low-pass filtered drums… |
| | **Epic orchestral** music · 30 s | Epic cinematic orchestral trailer music with thundering taiko drums, soaring French horns… |
| | **Chiptune adventure** music · 20 s · 150 BPM | Upbeat 8-bit chiptune adventure theme with a bright square wave lead… |
| | **Glass shatter** sfx · 3 s | source: glass bottle · action: shattering on impact · material: thick green glass · space: concrete floor |
| | **Rain & thunder** sfx · 12 s | source: heavy rain and distant thunder · space: outdoor forest at night, wide stereo |
| | **Synthwave, extended** edit · 20 s → 40 s | `edit_audio` continue: a 20-second track extended to 40 seconds |
MP3s are in `docs/samples/`, with prompts and seeds in `samples.json`.
## 🧭 How it works
 [code] 
## 🚀 Quick start
### macOS (Apple Silicon)
**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`)
 [code] 
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:
 [code] 
### Windows (