music-player MCP
Музыкальный сервер на Rust с MCP: агент ищет треки, собирает очередь и подбирает следующие по темпу и энергии.
- 533 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Агент управляет локальным демоном, видит библиотеку и историю прослушиваний, ставит и убирает треки.
- Скрипт установки из `curl | sh` и пакетные репозитории без проверки подписи стоит прочитать до запуска.
Установка
- Работает в
Ручная установка
curl -fsSL https://raw.githubusercontent.com/tsirysndr/music-player/master/install.sh | shПервый вариант из раздела Installation README. Есть также `npm install -g @tsiry/music-player` и Homebrew. Затем `claude mcp add music-player -- music-player mcp`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент управляет локальным демоном, видит библиотеку и историю прослушиваний, ставит и убирает треки.
- Скрипт установки из `curl | sh` и пакетные репозитории без проверки подписи стоит прочитать до запуска.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Music Player — музыкальный сервер и плеер на Rust в одном бинарном файле. Команда `music-player mcp` запускает MCP-сервер по stdio, через него агент управляет работающим демоном: узнает, что играет, ищет по библиотеке, ставит на паузу, собирает очередь. Анализ звука считает темп, энергию и яркость каждого трека, а авто-диджей поддерживает очередь из пяти композиций и ведет набор по заданной энергии. В комплекте скилл `skills/music-player/SKILL.md`: он учит агента ставить треки в очередь без прерывания и опираться на то, что реально есть в библиотеке. Сам плеер читает 40 с лишним форматов, имеет терминальный и веб-интерфейс, настольное приложение, GraphQL и gRPC.
Для кого. Владельцам локальной музыкальной библиотеки, которые хотят управлять плеером из чата с агентом и подбирать треки по звучанию.
Подходит, если
- Хочется сказать агенту «поставь что-то бодрое» и получить очередь, а не одиночный трек.
- Библиотека большая, и треки подбирают по темпу и энергии, а не по названию.
- Вечеринка требует плавного перехода от 90 до 128 ударов в минуту.
- Фоновая музыка для работы идет с автоматическим пополнением очереди.
- Разработчик пишет своего клиента поверх gRPC или GraphQL API того же сервера.
Не подходит, если
- Нужен потоковый сервис с каталогом: плеер играет вашу библиотеку и серверы Subsonic или Jellyfin.
- Демон не запущен, и агент должен сам его поднять: сервер MCP подключается к уже работающему.
- Хватает обычного плеера без управления голосом или чатом.
Пример запроса к агенту
Посмотри, что сейчас играет, и добавь в очередь девять бодрых треков из моей библиотеки, не прерывая текущий.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
MCP-сервер подключается к уже работающему демону по gRPC, поэтому плеер запускают заранее. Подбор по ощущению требует анализа библиотеки: он идет в фоне, около секунды на локальный файл. Приложение для macOS не подписано и не нотаризовано, Gatekeeper блокирует первый запуск. В разделе установки есть строки с `curl ... | sh` и репозитории с `trusted=yes`: проверяйте их до запуска. Сервер MCP не требует авторизации.
Как отключить. Удалите запись командой `claude mcp remove music-player` или уберите блок `music-player` из конфигурации клиента. Сам плеер удаляют менеджером пакетов, а базы и кэш анализа остаются в каталоге данных.
Частые вопросы
Как подключить MCP к Claude Code?
Командой `claude mcp add music-player -- music-player mcp`. Для клиентов с файлом настроек добавьте в `mcpServers` запись с командой `music-player` и аргументом `mcp`.
Зачем нужен скилл?
Он учит агента вести подборку как диджей: ставить в очередь, не прерывая игру, выстраивать набор и опираться на реальный состав библиотеки.
Что такое авто-диджей?
Режим, при котором очередь держится на пяти треках, каждый подбирается вслед за предыдущим по темпу и энергии. Целевую энергию можно менять словами.
Какие форматы читает плеер?
Больше 40, среди них MP3, FLAC, Opus, AAC, ALAC и WavPack, с цепочкой Rockbox: эквалайзер, кроссфейд и ReplayGain.
Где хранятся данные анализа?
В SQLite: каждый трек анализируется один раз. Теги `initialkey` и BPM из файла читаются до всякого вычисления.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер Spotify: агент ищет музыку, управляет воспроизведением, очередью и громкостью, собирает и правит плейлисты и медиатеку
MCP-сервер к локальному плееру и демону синхронизации Яндекс Музыки на Rust для Linux: управление плеером, вкус, подборки под настроение
MCP Music Studio — музыка в чате с агентом
mcp-music-studio
MCP-сервер, где агент пишет ноты в ABC или живой бит на Strudel, а плеер с редактором открывается прямо в чате
MCP-сервер редактора Audionaut: агент режет, двигает, затухает, анализирует и экспортирует многодорожечные проекты звука.
MCP-сервер Яндекс Музыки с локальным плеером для macOS
yandex-music-mcp
MCP-сервер Яндекс Музыки без браузера: агент собирает плейлист, локальный демон играет его через mpv с Now Playing в Control Center
Пакет audio запускает MCP для работы со звуком: громкость, спецификации, шумоподавление, эквалайзер, нарезка и темп.
Коротко о README
README перечисляет возможности, способы установки (curl, npm, Homebrew, пакеты Debian и RPM, AUR), раздел «AI agents (MCP)» с примерами диалога, анализ звука с авто-диджеем и аналитику прослушиваний на DuckDB.