README Documentation
melrose-mcp
melrōse is a tool to create and play music by programming melodies. It uses a custom language to compose notes and create loops and tracks to play.
melrose-mcp is an MCP server (STDIO) that uses the packages from the melrōse tool.
installation
This mcp server requires the Go SDK for installation. To produce music, you need to setup a MIDI receiver such as a DAW or a hardware synthesizer.
go install github.com/emicklei/melrose-mcp@latest
tools
- melrose_play
- melrose_bpm
- melrose_devices
- melrose_change_output_device
session
change the tempo in melrose to a lower value
melrose_bmp request:
{
`bpm`: `80`
}
llm response:
I've reduced the tempo to 80 beats per minute from the default of 120 BPM. This creates a more relaxed and slower pace for any musical expressions we play.
play a tune from Claude Debussy
llm response:
I'll create a small segment inspired by Claude Debussy's impressionist style using the Melrose language at our current tempo of 80 BPM.
melrose_play request:
{
`expression`: `sequence('(F4 A4 D5) 4(F4 A4 D5) (G4 B4 E5) 4(G4 B4 E5) (A4 C5 F5) 4(A4 C5 F5) (G4 B4 E5) 4(G4 B4 E5) (F4 A4 D5) 8= 8(E4 G4 C5) 4(F4 A4 D5)')`
}
melrose_play response:
12.749963417s
configuration in your client
Below an example to configure it in Claude Desktop.
{
"mcpServers": {
"melrōse": {
"command": "<YOUR DIRECTORY TO THE BINARY>/melrose-mcp",
"args": []
}
}
}
example prompts
- play the music sequence C D E
- play the first bar of fur elise
- play the famous tune from Mike Oldfield called Tubular Bells
- play the notes of Frere Jacques
- play the C# chord
To help your LLM understand the Melrōse language better, you can use this context.
Contributions
Fixes, suggestions, documentation improvements are all welcome. Fork this project and submit small Pull requests. Discuss larger ones in the Issues list. You can also sponsor Melrōse via Github Sponsors.
Software is licensed under MIT. © 2025 ernestmicklei.com