bfxr2-music-generator
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@bfxr2-music-generator Generate a laser sound effect"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Bfxr2 MCP Server
A Model Context Protocol (MCP) server that provides music and sound effect generation tools using the existing Bfxr2 codebase.
Table of Contents
Related MCP server: bfxr-mcp
Features
Sound Effect Generation: Create preset sound effects (pickup, laser, explosion, etc.)
Custom Sound Creation: Full parameter control for custom sounds
Random Generation: Generate random sounds with optional seeding
WAV Export: Export generated sounds as WAV files (base64 or data URI)
Parameter Inspection: View and modify sound parameters
Zero Code Duplication: Uses existing Bfxr2 JavaScript files directly
Installation
cd mcp
npm installMCP Server Configuration
To use the bfxr2 MCP server with Cline or other MCP clients, add this configuration:
{
"mcpServers": {
"bfxr2-music-generator": {
"autoApprove": [
"list_presets",
"get_parameters",
"generate_sound_effect",
"randomize_sound"
],
"disabled": false,
"timeout": 30,
"type": "stdio",
"command": "node",
"args": [
"/path/to/your/bfxr2/mcp/src/server.js"
]
}
}
}Note: Update the path in args to match your actual bfxr2 installation directory.
Usage
Start the MCP Server
npm startAvailable Tools
generate_sound_effect
Generate preset sound effects
Types: pickup, laser, explosion, powerup, hit, jump, blip
Optional custom parameter overrides
generate_named_sound
Generate sounds from precomputed named presets
Presets: cry, pluck, splash, droplet, rip, woof, pushrock, glass, bark, powerdown, smallbark, bounce
Each preset has carefully tuned parameters for specific sound characters
create_custom_sound
Full control over all sound parameters
Specify waveType, frequency, envelope, effects, etc.
create_sound_with_wave
Create sounds using wave type by name
Wave types: Square, Saw, Sin, White, Triangle, Rasp, Tan, Whistle, Breaker, Bitnoise, FMSyn, Voice
randomize_sound
Generate completely random sounds
Optional seed for reproducible results
mutate_sound
Create variations of the last generated sound
Slightly randomizes parameters while maintaining general character
export_wav
Export last generated sound as WAV
Formats: base64 or data URI
get_parameters
View current sound parameters
list_presets
List available generator presets (pickup, laser, etc.)
list_named_presets
List available named presets with descriptions (cry, bark, splash, etc.)
list_wave_types
List all available wave types with descriptions
Example Tool Calls
{
"name": "generate_sound_effect",
"arguments": {
"type": "laser",
"customParams": {
"frequency_start": 0.7,
"attackTime": 0.1
}
}
}{
"name": "create_custom_sound",
"arguments": {
"parameters": {
"waveType": 2,
"frequency_start": 0.5,
"sustainTime": 0.3,
"vibratoDepth": 0.2
}
}
}{
"name": "generate_named_sound",
"arguments": {
"preset": "bark",
"filepath": "/tmp/bark.wav"
}
}{
"name": "create_sound_with_wave",
"arguments": {
"waveType": "Whistle",
"parameters": {
"frequency_start": 0.6,
"sustainTime": 0.4
},
"filepath": "/tmp/whistle.wav"
}
}{
"name": "mutate_sound",
"arguments": {
"filepath": "/tmp/mutated.wav"
}
}Architecture
The MCP server uses a lightweight wrapper approach:
bfxr-wrapper.js: Provides minimal browser API mocks and loads existing Bfxr2 files
server.js: MCP server implementation with tool handlers
No code duplication: Directly imports from
../js/directory
Wave Types
ID | Name | Description |
0 | Square | Classic square wave, good for retro game sounds |
1 | Saw | Sawtooth wave, raspy and buzzy |
2 | Sin | Pure sine wave, clean and simple |
3 | White | White noise, good for explosions and static |
4 | Triangle | Triangle wave, softer than square |
5 | Rasp | Periodic 1-bit noise, digital buzz |
6 | Tan | Tangent wave, potentially crazy/distorted |
7 | Whistle | Sin with overtone, breathy/hollow |
8 | Breaker | Quadratic wave, smooth and slick |
9 | Bitnoise | Periodic 1-bit white noise, glitchy |
10 | FMSyn | FM synthesis, dense and breathy |
11 | Voice | Digital voice sample |
Named Presets
Pre-configured sounds with carefully tuned parameters:
Name | Wave Type | Description |
cry | Voice | A crying/whimpering voice sound |
pluck | Voice | A plucked string instrument sound |
splash | Sin | A water splash effect |
droplet | Whistle | A water droplet sound |
rip | Voice | A tearing/ripping sound |
woof | Square | A dog bark/woof sound |
pushrock | White | A heavy object pushing/scraping sound |
glass | Whistle | A glass breaking/tinkling sound |
bark | Rasp | A sharp bark sound |
powerdown | White | A power-down/shutdown sound |
smallbark | Rasp | A small/quiet bark sound |
bounce | FMSyn | A bouncy/springy sound |
Sound Parameters
Key parameters you can control:
waveType: Wave shape (0-11)frequency_start: Base frequency (0-1)frequency_slide: Frequency sweep (-0.5 to 0.5)attackTime: Volume envelope attack (0-1)sustainTime: Volume envelope sustain (0-1)decayTime: Volume envelope decay (0.03-1)vibratoDepth: Vibrato strength (0-1)vibratoSpeed: Vibrato speed (0-1)
Contributing
We welcome contributions! Please see CONTRIBUTING.md for guidelines on how to get started.
Changelog
See CHANGELOG.md for a list of changes in each version.
License
This project is licensed under the MIT License - see the LICENSE file for details.
Available Tools
11 toolscreate_custom_soundA
Create completely custom retro sound effects with full control over all synthesis parameters. Define waveform type (square, saw, sine, noise, etc.), frequency characteristics, envelope shaping (attack/sustain/decay), vibrato effects, and frequency slides to craft unique 8-bit style audio.
Inputs: parameters (required), filepath (required).
create_sound_with_waveB
Create a sound using a specific wave type by name. Allows specifying the wave type using its name (e.g., 'Square', 'Saw', 'Whistle') instead of a numeric ID.
Inputs: waveType (required), filepath (required), parameters.
export_wavA
Export the most recently generated sound effect to a new WAV file. Useful for saving variations of a sound or creating multiple copies with different filenames without regenerating the audio.
Inputs: filepath (required).
generate_named_soundA
Generate a sound from precomputed named presets. These are carefully crafted sound configurations for specific effects like 'cry', 'splash', 'bark', 'glass', etc. Each preset has been fine-tuned for a particular sound character.
Inputs: preset (required), filepath (required), customParams.
generate_sound_effectA
Generate retro-style game sound effects using built-in presets. Choose from classic 8-bit sounds like coin pickups, laser shots, explosions, powerups, hit sounds, jump effects, and UI blips. Optionally override specific parameters to customize the sound while maintaining the preset's character.
Inputs: type (required), filepath (required), customParams.
get_parametersA
Inspect the synthesis parameters of the last generated sound. Returns detailed information about waveform type, frequency settings, envelope characteristics, and effects. Essential for understanding how sounds are constructed, reverse-engineering presets, or using existing sounds as starting points for modifications.
Inputs: no named parameters.
list_named_presetsA
List all available named sound presets with descriptions. These are precomputed configurations for specific sound effects like animal sounds, environmental effects, and more.
Inputs: no named parameters.
list_presetsA
Display all available built-in sound effect presets with descriptions. Shows the complete library of retro game sounds including pickup coins, laser weapons, explosions, powerups, hit effects, jump sounds, and UI elements.
Inputs: no named parameters.
list_wave_typesA
List all available wave types (oscillator shapes) that can be used for sound generation. Each wave type produces a different tonal character - from clean sine waves to harsh noise.
Inputs: no named parameters.
mutate_soundB
Mutate the current sound by slightly randomizing its parameters. Creates variations of the last generated sound while maintaining its general character. Great for creating sound families or finding interesting variations.
Inputs: filepath (required).
randomize_soundA
Generate surprising and creative sound effects by randomizing all synthesis parameters. Perfect for discovering new sounds or creating unique audio textures. Use an optional seed value to make results reproducible for consistent random generation.
Inputs: filepath (required), seed.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 11 tools
Each tool targets a distinct action: creating from presets vs. custom parameters, listing different resource types, mutating vs. randomizing, and exporting. No two tools have overlapping purposes; descriptions clearly differentiate them.
The naming follows snake_case with a consistent verb_noun pattern (e.g., list_presets, create_custom_sound). Minor variation like 'create_sound_with_wave' (prepositional phrase) is slightly inconsistent but still clear.
11 tools is well-scoped for a sound generation server: discovery (list presets, wave types), generation (custom, presets, named), manipulation (mutate, randomize), export, and inspection. No unnecessary tools.
Covers the core workflow: listing presets, generating from presets, custom creation, mutation, randomization, export, and parameter inspection. Missing a tool to save custom presets, but the surface is largely complete for retro sound effects.
Maintenance
Related MCP Connectors
Generate sound effects and music from text for games, apps and videos. Returns audio file URLs.
Synth, sampler and music tracker for AI assistants: sound effects, UI sounds and songs as audio.
Game sound effects from a text prompt: game-ready WAVs with seamless loops and variations.
Generate, extend and edit sound effects for video and audio, and turn audio into MIDI, with Mirelo.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables local generation of game sound effects from text prompts using Stability AI's Stable Audio Open model, with no API keys or per-generation cost.1MIT
- AlicenseAqualityDmaintenanceMCP server for generating retro game sound effects using Bfxr synthesis. It provides tools to create, mutate, and load sound parameters, with output saved as WAV files and optional permalinks.5MIT
- AlicenseAqualityCmaintenanceEnables coding agents to synthesize and play video-game sound effects by translating natural-language descriptions into layered synthesis specs, then rendering normalized WAV files.9MIT
- AlicenseNot gradedqualityBmaintenanceEnables agents to find, preview, and download free CC0 sound effects by asking for a role, taking one of 18 curated sets, or running free-text search with duration, loop, and format constraints, returning permanent hotlinkable WAV/MP3 URLs. When nothing in the library fits, it can also generate new sounds from a description, with free takes to refine, given an API key.8Creative Commons Zero v1.0 Universal