Name: Sound
Author: seayniclabs

Sound — это нативный MCP-сервер для macOS, который позволяет ИИ-инструментам, таким как Claude Code, Cursor и Windsurf, искать, воспроизводить и управлять Apple Music с помощью естественного языка.

Никаких API-ключей. Никаких процессов авторизации в браузере. Одна команда для установки, один запрос для настройки.

Что он умеет

Инструмент	Описание
`search_catalog`	Поиск песен, альбомов или исполнителей в Apple Music
`get_song_details`	Получение полных метаданных песни
`get_album_details`	Получение информации об альбоме со списком треков
`play_song`	Воспроизведение конкретной песни по ID из каталога
`play_pause`	Переключение воспроизведения/паузы
`skip_next` / `skip_previous`	Навигация по трекам
`get_now_playing`	Информация о текущем треке и состоянии воспроизведения
`get_queue` / `set_queue`	Чтение или замена очереди воспроизведения
`get_library_playlists`	Список ваших плейлистов
`get_recently_played`	История недавнего прослушивания
`create_playlist`	Создание нового плейлиста
`add_to_playlist`	Добавление песен в плейлист
`ping`	Проверка работоспособности

Требования

macOS 14+ (Sonoma или новее) на Apple Silicon
Подписка Apple Music (для воспроизведения; поиск по каталогу работает и без неё)
ИИ-инструмент с поддержкой MCP (Claude Code, Cursor, Windsurf и т.д.)
Для сборки из исходного кода: Xcode 16.3+ / Swift 6.1+

Установка

Homebrew (рекомендуется)

brew install seayniclabs/tap/sound

Из исходного кода

git clone https://github.com/seayniclabs/sound.git
cd sound
swift build -c release
codesign --force --sign - --entitlements Sources/Sound/Sound.entitlements .build/release/Sound

Бинарный файл находится по адресу .build/release/Sound.

Первичная настройка

Запустите команду настройки, чтобы предоставить доступ к Apple Music:

sound setup

Это вызовет системный запрос macOS на разрешение доступа. Вам нужно сделать это только один раз.

Добавление в Claude Code

claude mcp add sound -- $(which sound)

Или добавьте вручную в ~/.claude.json:

{
  "mcpServers": {
    "sound": {
      "command": "/path/to/sound",
      "args": ["serve"]
    }
  }
}

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

После подключения просто общайтесь со своим ИИ-инструментом:

"Найди Tycho в Apple Music"
"Включи Everlong группы Foo Fighters"
"Создай плейлист под названием Focus и добавь туда эти треки"
"Что сейчас играет?"
"Переключи на следующий трек"

Как это работает

Sound использует фреймворк Apple MusicKit для нативного взаимодействия с Apple Music в macOS. Он обменивается данными с ИИ-инструментами через stdio, используя Model Context Protocol (JSON-RPC).

AI Tool  --stdio/JSON-RPC-->  Sound  --MusicKit-->  Apple Music
                                     --ApplicationMusicPlayer-->  Music.app

Авторизация обрабатывается macOS — бинарный файл имеет встроенный идентификатор пакета (com.seayniclabs.sound) и право доступа MusicKit. Пользователям достаточно один раз нажать "Разрешить" при появлении запроса. Никаких токенов, логики обновления или конфигурационных файлов.

Сборка

swift build           # debug build
swift build -c release  # release build

Sound требует Swift 6.1+ и предназначен для macOS 14+.

Лицензия

MIT

Авторы

Создано Seaynic Labs.

Sound