Melrose MCP

1## melrose-mcp 
2 
3[melrōse](https://melrōse.org) 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.
4 
5`melrose-mcp` is an [MCP](http://modelcontextprotocol.io/) server (STDIO) that uses the packages from the `melrōse` tool.
6 
7## installation
8 
9This mcp server requires the [Go SDK](https://go.dev) for installation.
10To produce music, you need to setup a MIDI receiver such as a DAW or a hardware synthesizer.
11 
12    go install github.com/emicklei/melrose-mcp@latest
13 
14## tools
15 
16- melrose_play
17- melrose_bpm
18- melrose_devices
19- melrose_change_output_device
20 
21## session
22 
23>   change the tempo in melrose to a lower value
24 
25`melrose_bmp` request:
26```javascript
27{
28  `bpm`: `80`
29}
30```
31 
32`llm` response:
33```
34I'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.
35```
36 
37>   play a tune from Claude Debussy
38 
39`llm` response:
40```
41I'll create a small segment inspired by Claude Debussy's impressionist style using the Melrose language at our current tempo of 80 BPM.
42```
43 
44`melrose_play` request:
45```javascript
46{
47  `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)')`
48}
49```
50`melrose_play` response:
51```javascript
5212.749963417s
53```
54 
55## configuration in your client
56 
57Below an example to configure it in Claude Desktop.
58 
59    {
60        "mcpServers": {
61            "melrōse": {
62              "command": "<YOUR DIRECTORY TO THE BINARY>/melrose-mcp",
63              "args": []
64            }
65        }
66    }
67 
68## example prompts
69 
70- play the music sequence  C D E
71- play the first bar of fur elise
72- play the famous tune from Mike Oldfield called Tubular Bells
73- play the notes of Frere Jacques
74- play the C# chord
75 
76To help your LLM understand the Melrōse language better, you can use this [context](resources/melrose_llm_context.txt).
77 
78### Contributions
79 
80Fixes, suggestions, documentation improvements are all welcome.
81Fork this project and submit small Pull requests. 
82Discuss larger ones in the Issues list.
83You can also sponsor Melrōse via [Github Sponsors](https://github.com/sponsors/emicklei).
84 
85Software is licensed under [MIT](LICENSE).
86&copy; 2025 [ernestmicklei.com](http://ernestmicklei.com)