mcp-apple-music — MCP-сервер для Claude Code: обзор и установка
Подключает Apple Music к ассистенту для поиска треков, управления плейлистами и работы с медиатекой. Пригодится для составления подборок и анализа истории прослушиваний прямо в чате.
claude mcp add --env APPLE_TEAM_ID=<APPLE_TEAM_ID> --env APPLE_KEY_ID=<APPLE_KEY_ID> --env APPLE_PRIVATE_KEY=<APPLE_PRIVATE_KEY> --env APPLE_MUSIC_USER_TOKEN=<APPLE_MUSIC_USER_TOKEN> --env APPLE_STOREFRONT=<APPLE_STOREFRONT> --transport stdio mcp-apple-music -- uvx mcp-apple-music-serverЧто делает mcp-apple-music
Сервер написан на FastMCP и предоставляет 14 инструментов для взаимодействия с REST API Apple Music. С его помощью агент просматривает сохранённые треки, проверяет недавнюю активность, ищет композиции в общем каталоге и создаёт новые подборки.
Управлять воспроизведением вроде паузы или переключения треков не выйдет, потому что REST API сервиса этого не умеет. Сервер рассчитан исключительно на работу с медиатекой и метаданными каталога. Для генерации ключа MusicKit обязательна платная учётная запись Apple Developer Program за 99 USD в год: на бесплатном тарифе создать ключ нельзя.
Авторизация делится на два этапа. Первый токен — это локальный Developer Token, который формируется на базе закрытого ключа .p8 и обновляется автоматически. Второй — пользовательский Music User Token, получаемый один раз через браузерный мастер настройки с MusicKit JS и сохраняемый в локальном файле конфигурации.
Какие задачи решает
- составить плейлист по недавней истории прослушиваний
- найти альбомы и исполнителей в каталоге Apple Music
- добавить треки из каталога в личную медиатеку
- проверить и изменить статус избранного у песни
Примеры запросов агенту
- Посмотри мои недавние альбомы и собери плейлист из десяти похожих песен, которых ещё нет в медиатеке.
- Найди все альбомы группы Radiohead и покажи, какие из них уже добавлены ко мне.
- Отметь трек с идентификатором
1440857781как избранный и добавь его в мой плейлист.
Как установить mcp-apple-music
Командой платформы
claude mcp add --env APPLE_TEAM_ID=<APPLE_TEAM_ID> --env APPLE_KEY_ID=<APPLE_KEY_ID> --env APPLE_PRIVATE_KEY=<APPLE_PRIVATE_KEY> --env APPLE_MUSIC_USER_TOKEN=<APPLE_MUSIC_USER_TOKEN> --env APPLE_STOREFRONT=<APPLE_STOREFRONT> --transport stdio mcp-apple-music -- uvx mcp-apple-music-serverВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-apple-music-server <команда>
Командой платформы
codex mcp add mcp-apple-music --env APPLE_TEAM_ID=<APPLE_TEAM_ID> --env APPLE_KEY_ID=<APPLE_KEY_ID> --env APPLE_PRIVATE_KEY=<APPLE_PRIVATE_KEY> --env APPLE_MUSIC_USER_TOKEN=<APPLE_MUSIC_USER_TOKEN> --env APPLE_STOREFRONT=<APPLE_STOREFRONT> -- uvx mcp-apple-music-serverВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-apple-music-server <команда>
Файл настроек
{
"mcpServers": {
"mcp-apple-music": {
"command": "uvx",
"args": [
"mcp-apple-music-server"
],
"env": {
"APPLE_TEAM_ID": "<APPLE_TEAM_ID>",
"APPLE_KEY_ID": "<APPLE_KEY_ID>",
"APPLE_PRIVATE_KEY": "<APPLE_PRIVATE_KEY>",
"APPLE_MUSIC_USER_TOKEN": "<APPLE_MUSIC_USER_TOKEN>",
"APPLE_STOREFRONT": "<APPLE_STOREFRONT>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-apple-music-server <команда>
Файл настроек
{
"servers": {
"mcp-apple-music": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-apple-music-server"
],
"env": {
"APPLE_TEAM_ID": "<APPLE_TEAM_ID>",
"APPLE_KEY_ID": "<APPLE_KEY_ID>",
"APPLE_PRIVATE_KEY": "<APPLE_PRIVATE_KEY>",
"APPLE_MUSIC_USER_TOKEN": "<APPLE_MUSIC_USER_TOKEN>",
"APPLE_STOREFRONT": "<APPLE_STOREFRONT>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-apple-music-server <команда>
Командой платформы
gemini mcp add -e APPLE_TEAM_ID=<APPLE_TEAM_ID> -e APPLE_KEY_ID=<APPLE_KEY_ID> -e APPLE_PRIVATE_KEY=<APPLE_PRIVATE_KEY> -e APPLE_MUSIC_USER_TOKEN=<APPLE_MUSIC_USER_TOKEN> -e APPLE_STOREFRONT=<APPLE_STOREFRONT> mcp-apple-music uvx mcp-apple-music-serverВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-apple-music-server <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-apple-music
Как установить mcp-apple-music в Claude Code?
Выполните в терминале команду `claude mcp add mcp-apple-music -e APPLE_TEAM_ID=<APPLE_TEAM_ID> -e APPLE_KEY_ID=<APPLE_KEY_ID> -e APPLE_PRIVATE_KEY=<APPLE_PRIVATE_KEY> -e APPLE_MUSIC_USER_TOKEN=<APPLE_MUSIC_USER_TOKEN> -- uvx mcp-apple-music-server` с вашими параметрами авторизации.
Можно ли переключать треки через этот MCP-сервер?
Нет. Интерфейс Apple Music REST API не поддерживает команды управления воспроизведением, поэтому поставить песню на паузу или пропустить трек через сервер нельзя.
Зачем нужна платная подписка Apple Developer Program?
Без платной подписки за 99 USD в год Apple не позволяет выпустить ключ MusicKit, необходимый для создания Developer Token.
