🎧 Listen to samples · · · · ·
Potencialize seu agente
Instalação do publicador. Não é um endpoint do PlugMCP.
Host a copy with our keys and logs.
Ainda não há uma versão empacotada no registro. Siga o README do repositório.
URL remota ou um comando na sua máquina? Como as duas instalações diferem
Rodar no PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
AbrirDo publicador
🎧 Listen to samples · · · · ·
Local AI BGM and sound effects for Claude Code and any MCP client. Stable Audio 3 on Apple Silicon (MLX) and Windows NVIDIA GPUs (PyTorch). No cloud, no API key.
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.
.json sidecar with its prompt, seed and settings.sa3 CLI. On Windows it calls the official Stable Audio 3 PyTorch API.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.
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<br/>PyTorch on NVIDIA GPUs"]
M --> F["WAV / OGG / FLAC + .json<br/>ready for game & video"]
Requirements:
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
Requirements:
git (winget install Git.Git) and ffmpeg (winget install Gyan.FFmpeg)git clone https://github.com/kanaworksai-hue/audio-studio-mcp.git
cd audio-studio-mcp
powershell -ExecutionPolicy Bypass -File install.ps1
The installer does the same steps as on macOS, but installs PyTorch with CUDA and downloads the official PyTorch checkpoint of the medium model (~10.4 GB). If you aren't logged in to Hugging Face yet, it asks for an access token with read permission (create one here). When it runs without a console (for example, started by an AI agent), it never asks: it prints the steps to log in and stops, and you re-run it after logging in. It finishes by printing the command to register the server:
claude mcp add --scope user audio-studio -- "C:\path\to\audio-studio-mcp\.venv\Scripts\audio-studio-mcp.exe"
Flash Attention is not needed. Without it, the runtime falls back to PyTorch's built-in attention.
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"
}
}
}
On Windows the command is C:\\path\\to\\audio-studio-mcp\\.venv\\Scripts\\audio-studio-mcp.exe (backslashes doubled in JSON).
On macOS, downloads are anonymous; logging in with hf auth login raises Hugging Face's rate limit. On Windows, the PyTorch weights are gated: accept the license on each model page you download (medium, small-music, small-sfx) and log in.
[!TIP] Let your agent install it. Paste this into Claude Code: "Install https://github.com/kanaworksai-hue/audio-studio-mcp by following its README, including the notes for AI agents, then register it as an MCP server."
Notes for AI agents (Windows only; macOS needs no login): the weights are gated and need the user's own Hugging Face login.
- Before downloading weights, check the login with
hf auth whoami(after the first installer run:.venv\Scripts\hf.exe auth whoami).install.ps1checks it too and stops withACTION NEEDEDwhen nobody is logged in.- If the user is not logged in, or the download fails with 401/403 (license not accepted, or accepted with another account), stop and pass the steps the installer printed on to the user: create a free account, accept the license on each model page, then run
hf auth loginin their own terminal. Wait until they say they are done, then re-run the installer.- Never ask the user to paste their token into the chat, and don't use
-SkipWeightsto get past this: generation would fail later with the same error.
Then just ask:
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.
Prefer clicking to chatting? The same server comes with a local web page. Generate BGM and sound effects, compare the candidates, edit them (make a variation, replace a part, extend), export them for your game or video, and browse everything you've made in the library.
.venv/bin/audio-studio-mcp --web 8765
Your browser opens http://127.0.0.1:8765/. Add --no-browser to start without opening it, or --preload to load the model at startup. Press Ctrl+C to stop it. On Windows: .venv\Scripts\audio-studio-mcp.exe --web 8765.
The page and your MCP clients can share one process and one loaded model: the same port also serves MCP at /mcp. Register it once and use both at the same time. Requests from the page and from agents wait in one queue.
claude mcp add --scope user --transport http audio-studio http://127.0.0.1:8765/mcp
outputs/, or AUDIO_STUDIO_OUTPUT_DIR). The library shows that folder, and the editor works on the files in it.[!WARNING] The web UI is for your own computer only. It listens on
127.0.0.1only and has no login. Don't make it reachable from other machines (port forwarding, a reverse proxy or a tunnel): anyone who can open it can use your GPU and write files to your output folder.
Pass them with claude mcp add ... -e NAME=value or in the env block of your client config.
Each client session normally starts its own server process. Models load on the first call and are freed after the idle timeout. To keep one warm process for every session, run it as a local HTTP server. It only listens on 127.0.0.1.
.venv/bin/audio-studio-mcp --http 8765 --preload
claude mcp add --scope user --transport http audio-studio http://127.0.0.1:8765/mcp
On Windows, start it with .venv\Scripts\audio-studio-mcp.exe --http 8765 --preload.
--web 8765 does the same and adds the web UI on the same port.
Medium model on an M1 Mac with 16 GB:
Medium model on Windows with an RTX 3060 12 GB:
On a Mac, loaded models use about 5–7 GB of memory. On the RTX 3060, the medium model peaked at about 5.3 GB of VRAM. Models are freed after the idle timeout or by unload_models.
bpm.
Lo-fi hip-hop chill track with mellow electric piano, soft vinyl crackle, low-pass filtered drums and soft plucked bass for a relaxed, dreamy vibe.
source: glass bottle / action: shattering on impact, fragments scattering / material: thick green glass, sharp bright transient / space: concrete floor, close-up, dry
inpaint or continue.steps=8 and cfg=1.0 are the official settings. For stricter prompt adherence, or to use negative_prompt, try cfg 3–7 (about 2× slower).variations and pick the best.The full guide is also sent to the client as the server's instructions.
Windows: yes, with an NVIDIA GPU. See Quick start.
Linux: with an NVIDIA GPU it uses the same PyTorch backend and should work, but it is untested and has no installer yet. Clone the upstream runtime into vendor/stable-audio-3 at the commit pinned in install.sh, then run uv sync --extra cuda and hf auth login.
Intel Macs and AMD GPUs are not supported.
The environment was built with an x86_64 Python (for example an old Intel Homebrew under /usr/local) that runs under Rosetta, so MLX was skipped. install.sh now asks uv for an arm64 Python and recreates such a .venv, so re-running ./install.sh fixes it. If you set UV_PYTHON yourself, point it at an arm64 build: UV_PYTHON=cpython-3.11-macos-aarch64 ./install.sh.
No. Stable Audio 3 generates instrumental music and sound effects. It cannot produce intelligible singing or lyrics.
The code here is MIT. The model weights are under the Stability AI Community License, which sets the terms for the model and what it generates. Read it before commercial use. At the time of writing it allows commercial use for individuals and organizations with less than US$1M in total annual revenue.
It hasn't been tested. The medium model needs about 5–7 GB while loaded, so 16 GB is recommended. The small sm-music / sm-sfx models are lighter.
Use WAV or OGG for loops. MP3 adds padding at the start and end, so it can't loop seamlessly. Also try a longer loop_crossfade_ms, or ask the model to cut on a bar line.
--web)Issues and pull requests are welcome.
If Audio Studio made a sound you ended up using, please click ⭐ Star at the top of the repository page. It's free, takes one second, and helps more than it looks:
Other ways to help: open an issue for a bug or an idea, or share a sound you made on X and tag @KanaWorks_AI.
uv run pytest # offline tests, no model needed
.venv/bin/python scripts/smoke_test.py # end-to-end with the real model (~30 s on an M1)
On Windows: .venv\Scripts\python scripts\smoke_test.py (~45 s on an RTX 3060, including model loading).
src/audio_studio_mcp/
server.py MCP tools (backend-independent)
prompts.py prompt building and the instructions sent to clients
post.py post-processing and export
backends/base.py backend interface
backends/sa3_mlx.py Stable Audio 3 on Apple Silicon (MLX)
backends/sa3_torch.py Stable Audio 3 on NVIDIA GPUs (PyTorch)
web.py web UI server (--web) and its JSON API
static/ web UI (HTML/JS/CSS, no build step)
A new platform is added as another backend in backends/.
vendor/ at install time. It is © Stability AI and MIT-licensed.stable-audio-3-optimized; Windows: stable-audio-3-medium and the small models), not distributed here.OFL.txt). The Kana images in the web UI (static/brand) are covered by the Brand note above.This is an independent project. It is not affiliated with or endorsed by Stability AI, Apple, NVIDIA or Anthropic.
Local AI BGM and sound effects for Claude Code and any MCP client. Stable Audio 3 on Apple Silicon (MLX) and Windows NVIDIA GPUs (PyTorch). No cloud, no API key.
Ferramentas
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
Este registro não lista nenhuma variável de ambiente obrigatória.
Audio Studio roda localmente via stdio.
Última verificação: 2026-11-17. Local AI BGM and sound effects for Claude Code and any MCP client. Stable Audio 3 on Apple Silicon (MLX) and Windows NVIDIA GPUs (PyTorch). No cloud, no API key.