Skip to main content
Glama
deenesjakoruzh
strongbeen04

musescore-mcp

by strongbeen04
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

musescore-mcp

Инструмент, который оборачивает CLI MuseScore в сервер протокола Model Context Protocol (MCP), позволяя Claude AI напрямую конвертировать, редактировать и анализировать нотные файлы.

Цель

Позволяет Claude AI (Claude Desktop, Claude Code и др.) работать с нотными файлами MuseScore (.mscz, .musicxml, MIDI и др.) с помощью команд на естественном языке.

Предоставляемые функции:

Категория

Функция

Конвертация и экспорт

Преобразование в PDF, PNG, MusicXML, MIDI, MP3 и другие форматы; извлечение партий; экспорт многостраничных PNG

Редактирование

Транспонирование по тональности, интервалу или для конкретного инструмента; изменение размера такта; изменение темпа

Анализ

Базовая информация о партитуре (название, композитор, размер, тональность, количество тактов); список изменений ключевых знаков; анализ состава инструментов и диапазона; гармонический анализ (римские цифры)

Дополнительно

Применение файлов стилей MuseScore (.mss); запуск плагинов QML; создание партитур из строк MusicXML; конвертация MIDI в ноты; отслеживание папок с автоматической конвертацией

Требования

  • Python 3.10 или выше

  • Установленный MuseScore 4 (или MuseScore 3)

    • Windows: musescore.org или Microsoft Store

    • Если путь установки отличается от стандартного, укажите путь к исполняемому файлу в переменной окружения MSCORE_PATH

Установка

1. Клонирование репозитория

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

2. Создание виртуального окружения и установка пакетов

python -m venv .venv

# Windows
.venv\Scripts\activate

# macOS / Linux
source .venv/bin/activate

# 기본 설치
pip install -e .

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

3. Регистрация MCP-сервера

Claude Desktop (версия из Windows Store)

Добавьте в файл %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 (обычная установка)

Добавьте в файл %APPDATA%\Claude\claude_desktop_config.json:

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

Claude Code (CLI)

Добавьте в файл ~/.claude.json:

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

Для macOS / Linux измените command на .venv/bin/musescore-mcp.

После сохранения настроек перезапустите Claude, чтобы подключить сервер musescore.

Использование

При общении с Claude прикрепите нотный файл или укажите путь к нему. Claude автоматически вызовет инструменты MCP.

Примеры использования:

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

Список доступных инструментов MCP

Инструмент

Описание

get_musescore_path

Проверка пути к исполняемому файлу MuseScore

convert_score

Конвертация одного файла

batch_convert

Пакетная конвертация нескольких файлов

export_parts

Извлечение партий по отдельности

export_png_pages

Экспорт многостраничных PNG

transpose_by_key

Транспонирование по тональности

transpose_by_interval

Транспонирование по интервалу

transpose_for_instrument

Транспонирование для инструмента

change_tempo

Изменение темпа (BPM)

change_time_signature

Изменение размера такта

get_score_info

Получение базовой информации о партитуре

get_key_signature

Список изменений ключевых знаков

list_instruments

Состав инструментов и их диапазоны

update_metadata

Редактирование метаданных (название, композитор и т.д.)

analyze_harmony

Гармонический анализ (требуется music21)

apply_style

Применение файла стиля MuseScore (.mss)

run_plugin

Запуск плагина QML

create_from_musicxml

Создание mscz из строки MusicXML

midi_to_score

Конвертация MIDI в mscz

watch_folder

Отслеживание папки и автоматическая конвертация

Purpose

musescore-mcp — это сервер MCP (Model Context Protocol), который оборачивает CLI MuseScore, позволяя Claude AI (Claude Desktop, Claude Code и др.) конвертировать, редактировать и анализировать нотные файлы с помощью команд на естественном языке.

Функции:

Категория

Возможности

Конвертация и экспорт

Конвертация в PDF, PNG, MusicXML, MIDI, MP3 и др.; извлечение отдельных партий; экспорт многостраничных PNG

Редактирование

Транспонирование по тональности или интервалу; транспонирование для конкретного инструмента; изменение темпа и размера такта

Анализ

Метаданные партитуры (название, композитор, тональность, размер, количество тактов); изменения ключевых знаков; диапазоны инструментов; гармонический анализ с использованием римских цифр

Дополнительно

Применение файлов стилей MuseScore (.mss); запуск плагинов QML; создание партитур из строк MusicXML; конвертация MIDI в ноты; автоматическая конвертация файлов в отслеживаемой папке

Требования

  • Python 3.10 или выше

  • Установленный MuseScore 4 (или MuseScore 3)

    • Windows: musescore.org или Microsoft Store

    • Если путь установки отличается от стандартного, установите переменную окружения MSCORE_PATH на путь к исполняемому файлу

Установка

1. Клонирование репозитория

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

2. Создание виртуального окружения и установка

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-сервера

Claude Desktop (Windows Store)

Отредактируйте %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 (стандартная установка)

Отредактируйте %APPDATA%\Claude\claude_desktop_config.json:

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

Claude Code (CLI)

Отредактируйте ~/.claude.json:

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

На macOS / Linux измените command на .venv/bin/musescore-mcp.

Перезапустите Claude после сохранения конфигурации, чтобы подключить сервер.

Использование

Прикрепите нотный файл в диалоге с Claude или укажите путь к нему и задайте вопрос на естественном языке. Claude автоматически вызовет соответствующие инструменты MCP.

Примеры:

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

Доступные инструменты MCP

Инструмент

Описание

get_musescore_path

Возвращает обнаруженный путь к исполняемому файлу MuseScore

convert_score

Конвертация одной партитуры в другой формат

batch_convert

Конвертация нескольких файлов за один вызов

export_parts

Экспорт каждой инструментальной партии в отдельный файл

export_png_pages

Экспорт всех страниц в виде отдельных PNG-изображений

transpose_by_key

Транспонирование в целевую тональность

transpose_by_interval

Транспонирование на определенный интервал

transpose_for_instrument

Переписывание транспозиции для заданного инструмента

change_tempo

Установка нового темпа (BPM)

change_time_signature

Изменение размера такта

get_score_info

Возвращает название, композитора, тональность, размер, темп, партии, количество тактов

get_key_signature

Список всех изменений ключевых знаков с номерами тактов

list_instruments

Возвращает названия инструментов, транспозиции и диапазоны высоты звука

update_metadata

Редактирование полей названия, композитора, автора текста и авторских прав

analyze_harmony

Анализ гармонических последовательностей (требуется music21)

apply_style

Применение файла стиля MuseScore (.mss)

run_plugin

Выполнение установленного плагина MuseScore QML

create_from_musicxml

Создание mscz из строки MusicXML

midi_to_score

Конвертация MIDI-файла в mscz

watch_folder

Мониторинг папки и автоматическая конвертация новых файлов .mscz

Лицензия

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