16bits-audio-mcp

16bits-gaudio-mcp

A Zig-powered MCP server that generates game audio — loopable BGMs, sound effects, and jingles — as 16-bit PCM WAV files.

Claude calls the tools, and .wav files come out. That's it.

• Zero external dependencies (Zig standard library only)
• 16-bit PCM WAV output
• FM synthesis, Schroeder reverb, ADSR envelopes, multi-track mixing
• Deterministic generation via seed — same seed = same output, every time

Samples

All samples below were generated by this tool. Click to listen on GitHub, or clone the repo to get the WAV files.

BGM

Sample	Style	Key / Scale	BPM
Adventure	adventure	C major	140
Boss Battle	boss	D minor	160
Town	town	F major	100
Cyber	cyber	A harmonic_minor	140
Horror	horror	C phrygian	70

Sound Effects

Jump	Coin	Explosion	Laser
Powerup	Dash	Shield	Warp
Thunder

Jingles

Stage Clear	Game Over	Victory
Item Get	Secret Found	Danger

Quick Start

brew tap matuyuhi/tools
brew install 16bits-audio-mcp

Add to your Claude config (~/.claude/settings.json for Claude Code, or claude_desktop_config.json for Desktop):

{
  "mcpServers": {
    "16bits-audio": {
      "command": "16bits-audio-mcp"
    }
  }
}

Then just ask Claude:

Generate a dungeon BGM at 90 BPM in A harmonic_minor, 8 bars, and play it

What You Can Generate

BGM — 15 styles

Full 4-track compositions (melody, bass, harmony, percussion) with per-style timbre, rhythm, and reverb.

Style	Mood	Time Sig.	Chord Progression
adventure	Bright, heroic	4/4	I–IV–V–I
dungeon	Dark, tense	4/4	i–VI–VII–i
boss	Aggressive, dramatic	4/4	i–bVII–bVI–V
town	Warm, waltz	3/4	I–V–vi–IV
battle	Intense, driving	4/4	ii–V–I–VI
field	Open, pastoral	4/4	I–vi–IV–V
puzzle	Quirky, thoughtful	5/4	I–iii–vi–IV
menu	Clean, ambient	4/4	I–IV–I–V
horror	Unsettling, sparse	4/4	i–bII–V–i
space	Ethereal, floating	4/4	Isus4–bVII–IV–I
shop	Upbeat, friendly	4/4	I–IV–iii–vi
castle	Regal, minor	4/4	i–iv–V–i
underwater	Dreamy, flowing	4/4	Isus2–IV–vi–Vsus4
forest	Natural, gentle	3/4	I–iii–IV–vi
cyber	Edgy, electronic	4/4	i–bVII7–bVI–bVII

Each style uses different waveforms, ADSR envelopes, percussion patterns (kick/snare/hihat/rim/shaker), swing, and reverb settings.

Sound Effects — 20 types

Type	Description	Duration
jump	Upward frequency sweep	200ms
hit	Noise burst, rapid decay	100ms
coin	Two-note chime (C6→E6)	150ms
explosion	Filtered noise rumble	800ms
laser	Downward sawtooth sweep	300ms
powerup	Ascending pentatonic arpeggio	500ms
error	Square wave with tremolo	200ms
footstep	Two filtered noise bursts	200ms
menu_select	Bright short blip	80ms
menu_cancel	Descending two-note blip	120ms
dash	Fast noise swoosh	250ms
shield	Metallic resonant tone	400ms
heal	Gentle ascending shimmer	600ms
charge	Rising frequency crescendo	800ms
warp	Wobbly FM sweep	500ms
door	Low resonant thud	350ms
switch	Short click-clack	60ms
splash	Filtered water noise	500ms
wind	Sustained modulated noise	1000ms
thunder	Crack + low rumble	1200ms

All SEs support pitch (0.5–2.0) and volume (0.0–1.0) for tuning.

Jingles — 12 types

Type	Mood	Waveform
stage_clear	Triumphant ascending + fanfare chord	sine
game_over	Descending minor with reverb	triangle
level_up	Quick ascending pentatonic	sine
item_get	Two bright notes	sine
boss_clear	Dramatic ascending + power chord	sine
victory	Fanfare brass ascending + big chord	sawtooth
defeat	Slow descending minor	triangle
secret_found	Mysterious chromatic sparkle	sine
save	Gentle confirmation chime	sine
shop_buy	Cheerful quick ding	square
danger	Urgent pulsing alarm (minor 2nd)	square
unlock	Bright ascending + shimmer chord	sine

Tempo feel options: fast, normal, slow, triumphant

Scales — 10 types

Scale	Intervals	Character
major	0, 2, 4, 5, 7, 9, 11	Bright, happy
minor	0, 2, 3, 5, 7, 8, 10	Sad, serious
pentatonic	0, 2, 4, 7, 9	Simple, universal
blues	0, 3, 5, 6, 7, 10	Bluesy, soulful
dorian	0, 2, 3, 5, 7, 9, 10	Jazz, folk
mixolydian	0, 2, 4, 5, 7, 9, 10	Rock, dominant
phrygian	0, 1, 3, 5, 7, 8, 10	Spanish, exotic
lydian	0, 2, 4, 6, 7, 9, 11	Dreamy, bright
harmonic_minor	0, 2, 3, 5, 7, 8, 11	Dramatic, Eastern
chromatic	0–11	All semitones

Audio Effects — 9 types (via wav_fx)

Effect	Parameters	Use Case
reverb	room_size (0–1), wet (0–1)	Space, depth
delay	delay_ms, feedback (0–1), wet (0–1)	Echo, rhythm
lowpass	cutoff_hz	Muffle, warmth
highpass	cutoff_hz	Thin, clarity
bandpass	low_hz, high_hz	Telephone, radio
chorus	depth (0–1), rate Hz, wet (0–1)	Width, shimmer
distortion	drive (0–1), wet (0–1)	Grit, aggression
bitcrusher	bit_depth (1–16), downsample (1–64)	Lo-fi, retro
tremolo	rate Hz, depth (0–1)	Pulsing, vibrato

Effects can be chained — they are applied in order.

Example Prompts

Basic Generation

Generate a boss battle BGM at 160 BPM in D minor, 8 bars

Create jump and coin sound effects, then play them

Make a victory jingle in G major with triumphant tempo

Creative Combinations

Generate a cyber BGM at 140 BPM in A harmonic_minor, then apply bitcrusher (8-bit, downsample 4) for retro feel

Create a forest BGM in E lydian at 100 BPM, 16 bars, then add chorus and reverb

Generate explosion, laser, and hit SEs with different pitches, then mix them with offsets into one file

Workflow: Iterate with Seeds

Generate a dungeon BGM with seed 42 — if you like the melody, keep the same seed and try different scales

The seed parameter makes BGM generation deterministic. Same seed + same parameters = same output. Change key, scale, or bpm while keeping the seed to preserve the melody shape.

Install

Homebrew (recommended)

brew tap Matuyuhi/tools
brew install 16bits-audio-mcp

One-liner

curl -fsSL https://raw.githubusercontent.com/Matuyuhi/16bits-gaudio-mcp/main/install.sh | bash

Build from source

Requires Zig 0.15.x.

git clone https://github.com/Matuyuhi/16bits-gaudio-mcp.git
cd 16bits-gaudio-mcp
zig build
# binary: zig-out/bin/16bits-audio-mcp

Or:

make install   # builds and installs to ~/.local/bin

Configuration

Claude Code

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "16bits-audio": {
      "command": "16bits-audio-mcp"
    }
  }
}

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "16bits-audio": {
      "command": "16bits-audio-mcp"
    }
  }
}

If you built from source, use the full path:

{
  "mcpServers": {
    "16bits-audio": {
      "command": "/path/to/zig-out/bin/16bits-audio-mcp"
    }
  }
}

Tools Reference (9 tools)

bgm_compose

Generate loopable BGM with 4 tracks (melody, bass, harmony, percussion).

Parameter	Type	Required	Description
output	string	yes	Output WAV file path
style	string	yes	One of 15 styles (see above)
bpm	number	yes	Beats per minute
duration_bars	number	yes	Number of bars
sample_rate	number	yes	Sample rate (e.g. 44100)
key	string	yes	Musical key (e.g. "C", "F#", "Bb")
scale	string	yes	One of 10 scales (see above)
seed	number	yes	Random seed for deterministic generation

jingle_gen

Generate short game event jingles.

Parameter	Type	Required	Description
output	string	yes	Output WAV file path
type	string	yes	One of 12 jingle types (see above)
sample_rate	number	yes	Sample rate
key	string	yes	Musical key
tempo_feel	string	yes	fast / normal / slow / triumphant

se_gen

Generate game sound effects.

Parameter	Type	Required	Description
output	string	yes	Output WAV file path
type	string	yes	One of 20 SE types (see above)
pitch	number	yes	Pitch multiplier (0.5–2.0)
volume	number	yes	Volume (0.0–1.0)
sample_rate	number	yes	Sample rate

note_synth

Synthesize single notes or chords to WAV.

Parameter	Type	Required	Description
output	string	yes	Output WAV file path
notes	string[]	yes	Note names (e.g. ["C4", "E4", "G4"])
waveform	string	yes	sine / square / sawtooth / triangle / pulse
duration_ms	number	yes	Duration in milliseconds
adsr	object	yes	{attack_ms, decay_ms, sustain_level, release_ms}
sample_rate	number	yes	Sample rate
reverb	boolean	no	Apply reverb (default: false)

fm_patch

Generate a tone using FM synthesis (YM2612-style 2-operator).

Parameter	Type	Required	Description
output	string	yes	Output WAV file path
carrier_note	string	yes	Carrier note (e.g. "A2")
modulator_ratio	number	yes	Modulator frequency ratio
modulation_index	number	yes	FM modulation depth
carrier_adsr	object	yes	Carrier ADSR envelope
modulator_adsr	object	yes	Modulator ADSR envelope
duration_ms	number	yes	Duration in milliseconds
sample_rate	number	yes	Sample rate

wav_fx

Apply effects chain to an existing WAV file.

Parameter	Type	Required	Description
input	string	yes	Input WAV file path
output	string	yes	Output WAV file path
effects	object[]	yes	Array of effects (see effect types above)

wav_mix

Mix multiple WAV files into one.

Parameter	Type	Required	Description
tracks	object[]	yes	{path, gain, offset_ms} array
output	string	yes	Output WAV file path
normalize	boolean	no	Normalize peak to -1 dBFS

wav_info

Get WAV file metadata and waveform statistics (sample rate, channels, bit depth, duration, RMS/peak dB).

Parameter	Type	Required	Description
path	string	yes	WAV file path

wav_play

Play a WAV file asynchronously (macOS: afplay, Linux: aplay).

Parameter	Type	Required	Description
path	string	yes	WAV file path

Supported Keys

C, C#, D, D#, E, F, F#, G, G#, A, A#, B (and flats: Db, Eb, Gb, Ab, Bb)

Note range: C0–B9 (MIDI 12–131). A4 = 440 Hz.

Tips

• Seed for iteration: Use seed to lock in a melody you like, then tweak key, scale, bpm, or style.
• Effect chaining: Apply multiple effects in sequence — e.g., bitcrusher → reverb for lo-fi ambient.
• Mixing workflow: Generate individual tracks (BGM, SEs, jingles), then combine with wav_mix using offset_ms for precise timing.
• Pitch shifting SEs: Use pitch: 0.5 for heavier sounds, pitch: 2.0 for lighter/faster variants.
• Lo-fi retro sound: Apply bitcrusher (bit_depth: 4–8, downsample: 2–8) to any generated audio.

Contributing

Issues and PRs welcome at Matuyuhi/16bits-gaudio-mcp.

zig build          # build
zig fmt src/       # format

License

MIT