Musescore MCP

🚀 Music Score Editing Assistant: MuseScore MCP Server

This MCP (Model Context Protocol) server integrates MuseScore with large language model clients like Claude Desktop, enabling natural language interaction for basic music composition.

Brief demo link: Canva Design Page

✨ Features

LLMs connected via MCP can perform the following operations:

• Connect to MuseScore and manipulate the opened music scores.
• Add notes and rests.
• Select and delete notes.
• Create tuplets.
• Undo changes.
• Switch between different voices.

⚠️ Limitations

• It cannot understand multiple voices within the same staff and navigate between them.

📋 System Requirements

• Python 3.9 or higher.
• Install MuseScore 3 or 4.
• MCP Python SDK.

📦 Installation

1. Clone this repository:

   git clone https://github.com/yourusername/musescore-mcp-server.git
   cd musescore-mcp-server
   

2. Install the dependencies, either using a virtual environment or globally:

   pip install -r requirements.txt
   

3. Copy the musescore-mcp-plugin to your MuseScore plugin directory (On my Mac, the path is: ~/Documents/MuseScore4/plugins).

4. Configure your LLM to use the MCP server (server.py). If you are using Claude Desktop and a virtual environment, you can create a claude_desktop_config file as follows:

   {
    "mcpServers": {
      "musescore": {
        "command": "bash",
        "args": [
          "-c",
          "source /path/to/venv/activate && python3 /path/to/server.py"
        ]
      }
    }
   }
   

💻 Usage Examples

Prepare MuseScore

Open MuseScore and the music score you need. Then, connect to the musescore-mcp-plugin and start it from the plugin menu.

Example Queries

Once the connection is successful, you can ask Claude the following questions:

• "Help me create some possible chords for the melody."
• "Based on the style of this piece, extend a 4-bar melody after bars 1 to 12."

🔧 Development

If you need to add features to the MuseScore plugin and test them, the testClient.html file provided in the repo can be a useful development tool - simply extend it to call your newly added features.