Skip to main content
Glama
deenesjakoruzh
strongbeen04

musescore-mcp

by strongbeen04
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

musescore-mcp

Una herramienta que envuelve la CLI de MuseScore como un servidor del Protocolo de Contexto de Modelo (MCP), permitiendo a Claude AI convertir, editar y analizar archivos de partituras directamente.

Propósito

Permite que Claude AI (Claude Desktop, Claude Code, etc.) maneje archivos de partituras de MuseScore (.mscz, .musicxml, MIDI, etc.) mediante comandos en lenguaje natural.

Funciones ofrecidas:

Categoría

Función

Conversión y exportación

Conversión a diversos formatos como PDF, PNG, MusicXML, MIDI, MP3; extracción de partituras por instrumento; exportación de PNG multipágina

Edición

Transposición de tonalidad, transposición de intervalos, transposición por instrumento; cambio de compás; cambio de tempo

Análisis

Información básica de la partitura (título, compositor, compás, tonalidad, número de compases); lista de cambios de armadura; análisis de instrumentación y rango tonal; análisis armónico (numeral romano)

Avanzado

Aplicación de archivos de estilo de MuseScore (.mss); ejecución de plugins QML; creación de partituras a partir de cadenas MusicXML; conversión de MIDI a partitura; conversión automática tras monitoreo de carpetas

Requisitos

  • Python 3.10 o superior

  • MuseScore 4 (o MuseScore 3) instalado

    • Windows: musescore.org o Microsoft Store

    • Si la ruta de instalación no es la estándar, especifique la ruta del ejecutable en la variable de entorno MSCORE_PATH

Instalación

1. Clonar el repositorio

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

2. Crear entorno virtual e instalar paquetes

python -m venv .venv

# Windows
.venv\Scripts\activate

# macOS / Linux
source .venv/bin/activate

# 기본 설치
pip install -e .

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

3. Registrar el servidor MCP

Claude Desktop (versión de Windows Store)

Añadir al archivo %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 (instalación estándar)

Añadir al archivo %APPDATA%\Claude\claude_desktop_config.json:

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

Claude Code (CLI)

Añadir al archivo ~/.claude.json:

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

Para macOS / Linux, cambie command a .venv/bin/musescore-mcp.

Tras guardar la configuración, reinicie Claude para conectar el servidor musescore.

Uso

Simplemente adjunte un archivo de partitura o indique su ruta mientras conversa con Claude. Claude llamará internamente a las herramientas MCP.

Ejemplos de uso:

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

Lista de herramientas MCP disponibles

Herramienta

Descripción

get_musescore_path

Verificar la ruta del ejecutable de MuseScore

convert_score

Conversión de formato de un solo archivo

batch_convert

Conversión por lotes de varios archivos

export_parts

Extracción individual de partituras por instrumento

export_png_pages

Exportación de PNG multipágina

transpose_by_key

Transposición basada en tonalidad

transpose_by_interval

Transposición basada en intervalos

transpose_for_instrument

Conversión de instrumentos transpositores

change_tempo

Cambio de tempo (BPM)

change_time_signature

Cambio de compás

get_score_info

Devolver información básica de la partitura

get_key_signature

Lista de cambios de armadura

list_instruments

Instrumentación y rangos tonales

update_metadata

Modificación de metadatos como título y compositor

analyze_harmony

Análisis de progresión armónica (requiere music21)

apply_style

Aplicación de archivo de estilo de MuseScore (.mss)

run_plugin

Ejecución de plugin QML

create_from_musicxml

Conversión de cadena MusicXML a mscz

midi_to_score

Conversión de MIDI a mscz

watch_folder

Conversión automática tras monitoreo de carpeta

Purpose

musescore-mcp is an MCP (Model Context Protocol) server that wraps the MuseScore CLI, enabling Claude AI (Claude Desktop, Claude Code, etc.) to convert, edit, and analyze music score files through natural language commands.

Features:

Category

Capabilities

Conversion & Export

Convert to PDF, PNG, MusicXML, MIDI, MP3, and more; extract individual parts; export multi-page PNGs

Editing

Transpose by key or interval; instrument-specific transposition; change tempo and time signature

Analysis

Score metadata (title, composer, key, time signature, measure count); key signature changes; instrument ranges; harmony analysis with Roman numerals

Advanced

Apply MuseScore style files (.mss); run QML plugins; create scores from MusicXML strings; convert MIDI to score; auto-convert files in a watched folder

Requirements

  • Python 3.10 or higher

  • MuseScore 4 (or MuseScore 3) installed

    • Windows: musescore.org or Microsoft Store

    • If installed to a non-standard path, set the MSCORE_PATH environment variable to the executable path

Installation

1. Clone the repository

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

2. Create a virtual environment and install

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. Register the MCP server

Claude Desktop (Windows Store)

Edit %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 (Standard install)

Edit %APPDATA%\Claude\claude_desktop_config.json:

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

Claude Code (CLI)

Edit ~/.claude.json:

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

On macOS / Linux, change command to .venv/bin/musescore-mcp.

Restart Claude after saving the config to connect the server.

Usage

Attach a score file in your Claude conversation or describe its path, and ask in natural language. Claude will call the appropriate MCP tools automatically.

Examples:

"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."

Available MCP Tools

Tool

Description

get_musescore_path

Return the detected MuseScore executable path

convert_score

Convert a single score to another format

batch_convert

Convert multiple files in one call

export_parts

Export each instrument part as a separate file

export_png_pages

Export all pages as individual PNG images

transpose_by_key

Transpose to a target key

transpose_by_interval

Transpose by a specific interval

transpose_for_instrument

Rewrite transposition for a given instrument

change_tempo

Set a new tempo (BPM)

change_time_signature

Change the time signature

get_score_info

Return title, composer, key, time sig, tempo, parts, measure count

get_key_signature

List all key signature changes with measure numbers

list_instruments

Return instrument names, transpositions, and pitch ranges

update_metadata

Edit title, composer, lyricist, and copyright fields

analyze_harmony

Analyze chord progressions (requires music21)

apply_style

Apply a MuseScore style file (.mss)

run_plugin

Execute an installed MuseScore QML plugin

create_from_musicxml

Create an mscz from a MusicXML string

midi_to_score

Convert a MIDI file to mscz

watch_folder

Monitor a folder and auto-convert new .mscz files

License

MIT

Install Server
F
license - not found
A
quality
D
maintenance

How are these scores calculated?

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.

Tools

View all tools

Related MCP Servers

  • Ableton MCP

    keigotak
    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

  • soundgrep

    fnsmdehip
    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

  • Lacuna Music

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

  • Garmin — MissingMCP

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

  • Fathom MCP Server

    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