Skip to main content
Glama

musescore-mcp

Ein Tool, das die MuseScore-CLI als Model Context Protocol (MCP)-Server verpackt, um Claude AI das direkte Konvertieren, Bearbeiten und Analysieren von Notendateien zu ermöglichen.


Zweck

Ermöglicht es Claude AI (Claude Desktop, Claude Code usw.), MuseScore-Notendateien (.mscz, .musicxml, MIDI usw.) über natürlichsprachliche Befehle zu verarbeiten.

Funktionen:

Kategorie

Funktion

Konvertierung & Export

Konvertierung in verschiedene Formate wie PDF, PNG, MusicXML, MIDI, MP3; Extraktion von Einzelstimmen; Export von mehrseitigen PNGs

Bearbeitung

Transposition nach Tonart, Intervall oder Instrument; Änderung von Taktart und Tempo

Analyse

Grundlegende Noteninformationen (Titel, Komponist, Taktart, Tonart, Taktanzahl); Liste der Tonartwechsel; Instrumentenbesetzung und Tonumfang; Harmonienanalyse (römische Ziffern)

Erweitert

Anwendung von MuseScore-Stildateien (.mss); Ausführen von QML-Plugins; Erstellung von Noten aus MusicXML-Strings; MIDI-zu-Noten-Konvertierung; automatische Konvertierung durch Ordnerüberwachung


Voraussetzungen

  • Python 3.10 oder höher

  • MuseScore 4 (oder MuseScore 3) installiert

    • Windows: musescore.org oder Microsoft Store

    • Falls der Installationspfad nicht dem Standard entspricht, muss der Pfad zur ausführbaren Datei in der Umgebungsvariablen MSCORE_PATH hinterlegt werden


Installation

1. Repository klonen

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

2. Virtuelle Umgebung erstellen und Pakete installieren

python -m venv .venv

# Windows
.venv\Scripts\activate

# macOS / Linux
source .venv/bin/activate

# 기본 설치
pip install -e .

# 화성 분석 기능(music21) 포함 설치
pip install -e ".[harmony]"

3. MCP-Server registrieren

Claude Desktop (Windows Store Version)

Fügen Sie dies zur Datei %LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "musescore": {
      "command": "C:\\path\\to\\musescore-mcp\\.venv\\Scripts\\musescore-mcp.exe"
    }
  }
}

Claude Desktop (Standardinstallation)

Fügen Sie dies zur Datei %APPDATA%\Claude\claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "musescore": {
      "command": "C:\\path\\to\\musescore-mcp\\.venv\\Scripts\\musescore-mcp.exe"
    }
  }
}

Claude Code (CLI)

Fügen Sie dies zur Datei ~/.claude.json hinzu:

{
  "mcpServers": {
    "musescore": {
      "type": "stdio",
      "command": "C:\\path\\to\\musescore-mcp\\.venv\\Scripts\\musescore-mcp.exe"
    }
  }
}

Unter macOS / Linux ändern Sie command zu .venv/bin/musescore-mcp.

Starten Sie Claude nach dem Speichern der Einstellungen neu, um den musescore-Server zu verbinden.


Verwendung

Sie können Notendateien in Ihrem Gespräch mit Claude anhängen oder den Pfad angeben. Claude ruft die MCP-Tools intern auf.

Anwendungsbeispiele:

"이 mscz 파일을 PDF로 변환해줘."
"악보를 Bb 클라리넷 기준으로 이조해줘."
"이 악보의 조성과 마디 수를 알려줘."
"MusicXML을 mscz 파일로 만들어줘."

Liste der verfügbaren MCP-Tools

Tool

Beschreibung

get_musescore_path

Überprüfung des Pfads zur MuseScore-Programmdatei

convert_score

Konvertierung eines einzelnen Dateiformats

batch_convert

Stapelverarbeitung mehrerer Dateien

export_parts

Separate Extraktion von Einzelstimmen

export_png_pages

Export von mehrseitigen PNGs

transpose_by_key

Transposition nach Tonart

transpose_by_interval

Transposition nach Intervall

transpose_for_instrument

Transposition für transponierende Instrumente

change_tempo

Änderung des Tempos (BPM)

change_time_signature

Änderung der Taktart

get_score_info

Abruf grundlegender Noteninformationen

get_key_signature

Liste der Tonartwechsel

list_instruments

Instrumentenbesetzung und Tonumfang

update_metadata

Bearbeitung von Metadaten wie Titel oder Komponist

analyze_harmony

Analyse der Harmoniefolge (erfordert music21)

apply_style

Anwendung einer MuseScore-Stildatei (.mss)

run_plugin

Ausführung eines QML-Plugins

create_from_musicxml

Konvertierung von MusicXML-Strings zu .mscz

midi_to_score

Konvertierung von MIDI zu .mscz

watch_folder

Überwachung eines Ordners zur automatischen Konvertierung


Zweck

musescore-mcp ist ein MCP-Server (Model Context Protocol), der die MuseScore-CLI umschließt und es Claude AI (Claude Desktop, Claude Code usw.) ermöglicht, Notendateien durch natürlichsprachliche Befehle zu konvertieren, zu bearbeiten und zu analysieren.

Funktionen:

Kategorie

Fähigkeiten

Konvertierung & Export

Konvertierung in PDF, PNG, MusicXML, MIDI, MP3 und mehr; Extraktion von Einzelstimmen; Export von mehrseitigen PNGs

Bearbeitung

Transposition nach Tonart oder Intervall; instrumentenspezifische Transposition; Änderung von Tempo und Taktart

Analyse

Noten-Metadaten (Titel, Komponist, Tonart, Taktart, Taktanzahl); Tonartwechsel; Instrumentenbereiche; Harmonienanalyse mit römischen Ziffern

Erweitert

Anwendung von MuseScore-Stildateien (.mss); Ausführen von QML-Plugins; Erstellung von Noten aus MusicXML-Strings; MIDI-zu-Noten-Konvertierung; automatische Konvertierung in einem überwachten Ordner


Voraussetzungen

  • Python 3.10 oder höher

  • MuseScore 4 (oder MuseScore 3) installiert

    • Windows: musescore.org oder Microsoft Store

    • Falls der Installationspfad nicht dem Standard entspricht, setzen Sie die Umgebungsvariable MSCORE_PATH auf den Pfad der ausführbaren Datei


Installation

1. Repository klonen

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

2. Virtuelle Umgebung erstellen und installieren

python -m venv .venv

# Windows
.venv\Scripts\activate

# macOS / Linux
source .venv/bin/activate

# Base install
pip install -e .

# With harmony analysis support (music21)
pip install -e ".[harmony]"

3. MCP-Server registrieren

Claude Desktop (Windows Store)

Bearbeiten Sie %LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "musescore": {
      "command": "C:\\path\\to\\musescore-mcp\\.venv\\Scripts\\musescore-mcp.exe"
    }
  }
}

Claude Desktop (Standardinstallation)

Bearbeiten Sie %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "musescore": {
      "command": "C:\\path\\to\\musescore-mcp\\.venv\\Scripts\\musescore-mcp.exe"
    }
  }
}

Claude Code (CLI)

Bearbeiten Sie ~/.claude.json:

{
  "mcpServers": {
    "musescore": {
      "type": "stdio",
      "command": "C:\\path\\to\\musescore-mcp\\.venv\\Scripts\\musescore-mcp.exe"
    }
  }
}

Unter macOS / Linux ändern Sie command zu .venv/bin/musescore-mcp.

Starten Sie Claude neu, nachdem Sie die Konfiguration gespeichert haben, um den Server zu verbinden.


Verwendung

Hängen Sie eine Notendatei an Ihr Gespräch mit Claude an oder beschreiben Sie den Pfad und stellen Sie Ihre Frage in natürlicher Sprache. Claude ruft die entsprechenden MCP-Tools automatisch auf.

Beispiele:

"Convert this mscz file to PDF."
"Transpose this score for Bb clarinet."
"What is the key and measure count of this score?"
"Create an mscz from this MusicXML."

Verfügbare MCP-Tools

Tool

Beschreibung

get_musescore_path

Gibt den erkannten Pfad zur MuseScore-Programmdatei zurück

convert_score

Konvertiert eine einzelne Partitur in ein anderes Format

batch_convert

Konvertiert mehrere Dateien in einem Aufruf

export_parts

Exportiert jede Instrumentenstimme als separate Datei

export_png_pages

Exportiert alle Seiten als einzelne PNG-Bilder

transpose_by_key

Transponiert in eine Zieltonart

transpose_by_interval

Transponiert um ein bestimmtes Intervall

transpose_for_instrument

Schreibt die Transposition für ein bestimmtes Instrument um

change_tempo

Setzt ein neues Tempo (BPM)

change_time_signature

Ändert die Taktart

get_score_info

Gibt Titel, Komponist, Tonart, Taktart, Tempo, Stimmen und Taktanzahl zurück

get_key_signature

Listet alle Tonartwechsel mit Taktnummern auf

list_instruments

Gibt Instrumentennamen, Transpositionen und Tonumfänge zurück

update_metadata

Bearbeitet Titel, Komponist, Liedtexter und Copyright-Felder

analyze_harmony

Analysiert Akkordfolgen (erfordert music21)

apply_style

Wendet eine MuseScore-Stildatei (.mss) an

run_plugin

Führt ein installiertes MuseScore QML-Plugin aus

create_from_musicxml

Erstellt eine .mscz aus einem MusicXML-String

midi_to_score

Konvertiert eine MIDI-Datei in .mscz

watch_folder

Überwacht einen Ordner und konvertiert neue .mscz-Dateien automatisch


Lizenz

MIT

Install Server
F
license - not found
A
quality
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables natural language control over Ableton Live for generating musical patterns, melodies, and full song arrangements. It also provides tools for sample searching and mixing assistance through an OSC-based connection with Claude Desktop.
    1
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables semantic search of local audio samples by describing sounds, MIDI generation, stem separation, and other music production tools from Claude Desktop.
    1
    MIT

View all related MCP servers

Related MCP Connectors

  • Generate AI music via the Lacuna Music API from MCP clients like Claude Desktop & Code.

  • Garmin data in Claude: 135 tools — activities, sleep, HRV, training, workouts. Free, open source.

  • Connect Claude to Fathom meeting recordings, transcripts, and summaries

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/strongbeen04/MUSESCORE-MCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server