# Audio Studio

Audio Studio is an MCP server for Claude Code that creates local music and sound effects with Stable Audio 3. It can also edit clips and prepare audio for games or video.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 698 repo stars
- Author: kanaworksai-hue
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/kanaworksai-hue/audio-studio-mcp
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/audio-studio

## What it does

Audio Studio turns a plain-language request into background music, an instrument loop, or a sound effect. Stable Audio 3 runs on the local machine through MLX on Apple Silicon or PyTorch on an NVIDIA GPU. The server can restyle a clip, regenerate part of a timeline, extend a track, and adjust loudness.

Exports use WAV, OGG, or FLAC, with loop handling and a JSON sidecar containing the prompt, seed, and settings. Nothing is uploaded, and the setup does not require an API key. Running it requires `uv` version `0.9.20` or newer plus `ffmpeg`; macOS needs Apple Silicon M1 or later, while Windows needs an NVIDIA GPU.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `AUDIO_STUDIO_OUTPUT_DIR`, `AUDIO_STUDIO_SA3_MODEL`, `AUDIO_STUDIO_IDLE_UNLOAD_MIN` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env AUDIO_STUDIO_OUTPUT_DIR=<AUDIO_STUDIO_OUTPUT_DIR> --env AUDIO_STUDIO_SA3_MODEL=<AUDIO_STUDIO_SA3_MODEL> --env AUDIO_STUDIO_IDLE_UNLOAD_MIN=<AUDIO_STUDIO_IDLE_UNLOAD_MIN> --transport stdio audio-studio -- uvx audio-studio-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from audio-studio-mcp <command>

### Codex

**Platform CLI**
```bash
codex mcp add audio-studio --env AUDIO_STUDIO_OUTPUT_DIR=<AUDIO_STUDIO_OUTPUT_DIR> --env AUDIO_STUDIO_SA3_MODEL=<AUDIO_STUDIO_SA3_MODEL> --env AUDIO_STUDIO_IDLE_UNLOAD_MIN=<AUDIO_STUDIO_IDLE_UNLOAD_MIN> -- uvx audio-studio-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from audio-studio-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "audio-studio": {
            "command": "uvx",
            "args": [
                "audio-studio-mcp"
            ],
            "env": {
                "AUDIO_STUDIO_OUTPUT_DIR": "<AUDIO_STUDIO_OUTPUT_DIR>",
                "AUDIO_STUDIO_SA3_MODEL": "<AUDIO_STUDIO_SA3_MODEL>",
                "AUDIO_STUDIO_IDLE_UNLOAD_MIN": "<AUDIO_STUDIO_IDLE_UNLOAD_MIN>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from audio-studio-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "audio-studio": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "audio-studio-mcp"
            ],
            "env": {
                "AUDIO_STUDIO_OUTPUT_DIR": "<AUDIO_STUDIO_OUTPUT_DIR>",
                "AUDIO_STUDIO_SA3_MODEL": "<AUDIO_STUDIO_SA3_MODEL>",
                "AUDIO_STUDIO_IDLE_UNLOAD_MIN": "<AUDIO_STUDIO_IDLE_UNLOAD_MIN>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from audio-studio-mcp <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e AUDIO_STUDIO_OUTPUT_DIR=<AUDIO_STUDIO_OUTPUT_DIR> -e AUDIO_STUDIO_SA3_MODEL=<AUDIO_STUDIO_SA3_MODEL> -e AUDIO_STUDIO_IDLE_UNLOAD_MIN=<AUDIO_STUDIO_IDLE_UNLOAD_MIN> audio-studio uvx audio-studio-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from audio-studio-mcp <command>

## When to use it
- create background music for a game or video
- generate a scene-specific sound effect from text
- extend an existing audio track
- prepare a loop with a clean repeat
- export generated audio as WAV, OGG, or FLAC

## Example prompts
- Create calm menu music for a game and return several variations.
- Generate a glass-breaking sound for a scene on a concrete floor.
- Extend `track.wav` and prepare it for repeated playback.

## Similar
- [stable-audio](https://affpapa.org/en/nevibecode/skills/stable-audio.md) — skill · 139 installs
- [procedural-audio](https://affpapa.org/en/nevibecode/skills/procedural-audio.md) — skill · ★ 56 repo stars
- [videoagent-audio-studio](https://affpapa.org/en/nevibecode/skills/videoagent-audio-studio.md) — skill · 4000 installs
- [video-to-audio-foley](https://affpapa.org/en/nevibecode/skills/video-to-audio-foley.md) — skill · 164 installs
- [layer-audio](https://affpapa.org/en/nevibecode/skills/layer-audio.md) — skill · 4900 installs
- [ai-music-audio](https://affpapa.org/en/nevibecode/skills/ai-music-audio.md) — skill · 107 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
