Skip to main content
Glama

Bfxr2 MCP Server

License: MIT Node.js Version MCP

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 install

MCP 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 start

Available Tools

  1. generate_sound_effect

    • Generate preset sound effects

    • Types: pickup, laser, explosion, powerup, hit, jump, blip

    • Optional custom parameter overrides

  2. 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

  3. create_custom_sound

    • Full control over all sound parameters

    • Specify waveType, frequency, envelope, effects, etc.

  4. 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

  5. randomize_sound

    • Generate completely random sounds

    • Optional seed for reproducible results

  6. mutate_sound

    • Create variations of the last generated sound

    • Slightly randomizes parameters while maintaining general character

  7. export_wav

    • Export last generated sound as WAV

    • Formats: base64 or data URI

  8. get_parameters

    • View current sound parameters

  9. list_presets

    • List available generator presets (pickup, laser, etc.)

  10. list_named_presets

    • List available named presets with descriptions (cry, bark, splash, etc.)

  11. 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 tools
create_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

    A3.8/5.0

    Scored across 11 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Enables coding agents to synthesize and play video-game sound effects by translating natural-language descriptions into layered synthesis specs, then rendering normalized WAV files.
      9
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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.
      8
      Creative Commons Zero v1.0 Universal