chord-player-mcp
An MCP server that plays chord progressions via MIDI/WAV synthesis.
Prerequisites
- FluidSynth with a SoundFont installed
- uv (for
uvx)
# macOS
brew install fluid-synthSetup (Claude Code)
Add the following to the mcpServers section in your ~/.claude.json:
{
"mcpServers": {
"chord-player": {
"command": "uvx",
"args": ["--from", "git+https://github.com/mohhh-ok/chord-player-mcp@v0.1.1", "chord-player-mcp"]
}
}
}MCP Tools
play_chords
Play a chord progression.
| Parameter | Description | Default | |-----------|-------------|---------| | chords | Space-separated chord progression (e.g. "C Am F G") | required | | bpm | Tempo | 120 | | beats | Beats per chord | 4 | | instrument | Instrument name or GM program number | piano | | voicing | close / open / drop2 | close | | velocity | Volume (0-127) | 90 | | output | Output WAV path (temp file if omitted) | - |
list_instruments
Returns a list of available instrument names.
Supported Chords
Major (C), minor (Cm), 7th (C7), maj7 (Cmaj7), m7 (Cm7), dim, dim7, aug, sus2, sus4, 7sus4, add9, madd9, 6, m6, 9, maj9, m9, 5 (power chord). Slash chords (C/E) are also supported.
Instruments
piano, electric_piano, guitar, acoustic_guitar, organ, strings, bass, violin, flute, sax, trumpet, synth_pad, vibraphone, choir, and more.
Examples
# Basic progression
play_chords("C Am F G")
# Jazz voicing
play_chords("Cmaj7 Am7 Dm7 G7", bpm=90, instrument="electric_piano", voicing="drop2")
# Guitar ballad
play_chords("G Em C D", bpm=72, instrument="guitar", beats=8, voicing="open")
# Slash chords
play_chords("C C/B Am Am/G F G C", bpm=100)
