MuseScore MCP Server
MCP-сервер управляет открытой партитурой MuseScore: агент пишет ноты, слова песни, повторы и цветовую разметку.
- 144 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Сервер редактирует открытую партитуру и может менять и удалять такты.
- Плагин открывает локальный порт WebSocket, через который MuseScore принимает команды.
Установка
- Работает в
Ручная установка
uvx --from "fastmcp>=4,<5" fastmcp install claude-desktop server.py --name musescore --python 3.13 --with-requirements requirements.txtКоманду выполняют из папки клона репозитория. Перед этим плагин `musescore-mcp-websocket.qml` копируют в папку плагинов MuseScore.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Сервер редактирует открытую партитуру и может менять и удалять такты.
- Плагин открывает локальный порт WebSocket, через который MuseScore принимает команды.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
MCP-сервер на Python связывает агента с открытой партитурой MuseScore через плагин QML и WebSocket. Агент записывает ноты в нужном такте, добавляет текст песни, меняет темп, читает партитуру по 16 тактов в сжатом виде LilyPond и размечает ее цветом и рамками. Всего у сервера 57 публичных инструментов. Отдельные инструменты сворачивают партитуру повторами: находят одинаковые такты, ставят репризные линии, вольты и число проигрываний. Для ударных есть карта разделов, знаки повтора такта и сборка чарта только из партии барабанов. Скилл `musescore-drum-chart` проводит этот процесс целиком, например от табулатуры Songsterr до чарта, готового к печати.
Для кого. Музыкантам и аранжировщикам, которые работают в MuseScore 4 и правят партитуры в диалоге с Claude.
Подходит, если
- В такте 3 нужно записать арпеджио до мажор, а с первого такта добавить слова песни.
- Партитура на двадцать станов не помещается в контекст, и ее читают по 16 тактов.
- Барабанный чарт из импорта Guitar Pro сворачивают повторами с числом проигрываний.
- Заполнения, остановки и крэши в партии выделяют цветом перед печатью.
Не подходит, если
- MuseScore закрыт или плагин API-сервера не запущен: сервер говорит с программой через WebSocket.
- Версия MuseScore старше 4.7: новые функции проверены только на 4.7.6.
- Партитура существует в единственной копии без резервной: инструменты правят открытый документ.
Пример запроса к агенту
Найди повторяющиеся фрагменты в открытой партитуре и поставь их между репризными линиями с числом проигрываний.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
Нужны MuseScore 4.x, Python 3.13 и MCP-клиент, например Claude Desktop. Плагин `musescore-mcp-websocket.qml` копируют в папку плагинов MuseScore и включают в Plugin Manager, а перед каждым сеансом запускают из меню Plugins, пункт MuseScore API Server. Порядок такой: сначала MuseScore с открытой партитурой и плагином, затем сервер. Новые инструменты проверены на версии 4.7.6. У установок через Snap или Flatpak папка плагинов может отличаться. Скилл барабанного чарта в Claude Desktop загружают отдельным ZIP-архивом.
Как отключить. Удалите запись `musescore` из конфигурации MCP-клиента и выключите плагин MuseScore API Server в Plugin Manager. Файл `musescore-mcp-websocket.qml` можно убрать из папки плагинов.
Частые вопросы
Как подключить сервер к Claude Desktop?
Из папки репозитория выполните `uvx --from "fastmcp>=4,<5" fastmcp install claude-desktop server.py --name musescore --python 3.13 --with-requirements requirements.txt`. Команда сама запишет конфигурацию.
Что нужно запустить до начала работы?
MuseScore с открытой партитурой, затем плагин из меню Plugins, пункт MuseScore API Server. В консоли появится сообщение о запуске сервера на порту 8765.
Что делает скилл musescore-drum-chart?
Он работает с копией только с партией ударных, составляет карту разделов, ждет вашего подтверждения и сворачивает группы тактов в повторы. Оригинальную партитуру скилл не сохраняет.
Можно ли отменить изменения?
Да. Все, что добавляют инструменты, снимается теми же словами: убрать звездочки, сбросить подсветку крэшей, вернуть нумерацию тактов.
Нужен ли Claude Desktop?
Нет, подойдет любой MCP-клиент. Claude Desktop описан в README как основной вариант, а скиллы из папки `skills/` кладут и в Claude Code, скопировав или связав их с `~/.claude/skills`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP Music Studio — музыка в чате с агентом
mcp-music-studio
MCP-сервер, где агент пишет ноты в ABC или живой бит на Strudel, а плеер с редактором открывается прямо в чате
MCP-сервер из 181 инструмента: агент пишет MIDI, сводит и мастерит треки в REAPER, не отправляя проект в облако.
MCP-сервер Spotify: агент ищет музыку, управляет воспроизведением, очередью и громкостью, собирает и правит плейлисты и медиатеку
Навык превращает запись песни в аранжировку для школьной группы из пяти инструментов: MIDI, PDF и редактируемый файл MuseScore
MCP-сервер для REAPER: агент создает проекты, дорожки и MIDI, расставляет эффекты, сводит, мастерит и рендерит трек
MCP-сервер для Ableton Live: агент создает дорожки, расставляет клипы и собирает аранжировку прямо в открытом проекте
Коротко о README
README показывает, что умеет сервер: писать и править ноты, читать большие партитуры, сворачивать их повторами, собирать барабанные чарты и размечать цветом. Дальше идут пример работы от Songsterr до PDF и ссылки на документацию.