apple_music_mcp
Apple Music MCP
Высокопроизводительный сервер Model Context Protocol (MCP) для Apple Music. Гибридный движок: нативный macOS JXA и облачный REST, с кроссплатформенным поиском, асинхронной пакетной обработкой и выполнением без тайм-аута.
⚡ Быстрый старт
Запустите мгновенно с помощью npx или uvx (установка не требуется):
Вариант A: использование npx (рекомендуется)
npx -y @saitarrunpitta/apple-music-mcpВариант B: использование uvx
uvx --from git+https://github.com/saitarrun/apple-music-mcp.git apple-music-mcp serveВариант C: локальная установка через npm или pip
npm install -g @saitarrunpitta/apple-music-mcp
# or
pip install git+https://github.com/saitarrun/apple-music-mcp.gitRelated MCP server: mcp-applemusic
🔌 Настройка MCP-клиента
Добавьте apple-music в вашего любимого ИИ-ассистента за считанные секунды:
1. Antigravity / AGY CLI
agy mcp add apple-music -- npx -y @saitarrunpitta/apple-music-mcp2. Claude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"apple-music": {
"command": "npx",
"args": [
"-y",
"@saitarrunpitta/apple-music-mcp"
]
}
}
}3. Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"apple-music": {
"command": "npx",
"args": [
"-y",
"@saitarrunpitta/apple-music-mcp"
]
}
}
}4. Codex MCP
codex mcp add apple-music -- npx -y @saitarrunpitta/apple-music-mcp✨ Возможности
⚡ Движок JXA без тайм-аутов: Читает плейлисты с 1,000+ треков менее чем за 100 мс без зависаний AppleScript.
🌐 Кроссплатформенные чарты: Прямые ленты открытий из Shazam, Spotify, YouTube и Apple Music.
🚀 Асинхронная пакетная обработка: Добавление или удаление 100+ треков параллельно менее чем за 1 секунду.
🎵 Только аудио: Автоматически отфильтровывает музыкальные клипы и видео с текстами песен, чтобы в плейлистах оставался только звук.
🛡️ 100% защита от дубликатов: Встроенное нечёткое сопоставление предотвращает повторное добавление треков.
🔐 Автоматическая авторизация через Safari: Бесшовно извлекает токены веб-плеера из Safari без ручных API-ключей.
🧠 Умные рекомендации: Рекомендации треков в реальном времени на основе вашей истории прослушивания и схожести исполнителей.
🛠️ Справочник инструментов
Категория | Инструмент | Описание |
Обнаружение |
| Получайте главные хиты из чартов Shazam, Spotify, YouTube или Apple Music. |
| Наполняйте плейлист напрямую из любого чарта с дедупликацией. | |
| Умные рекомендации на основе истории прослушивания и исполнителей. | |
| Получайте недавнюю историю прослушивания из облака Apple Music. | |
| Получайте самые часто воспроизводимые альбомы и плейлисты. | |
Плейлисты |
| Список всех плейлистов библиотеки с количеством треков и описаниями. |
| Быстрое массовое получение треков (название, исполнитель, альбом, длительность). | |
| Параллельное пакетное добавление без дубликатов. | |
| Массовое удаление по ID связей треков. | |
| Создание нового плейлиста с произвольным описанием. | |
| Безопасное удаление плейлиста без удаления песен из библиотеки. | |
| Обновление описания плейлиста и синхронизация с iCloud. | |
Каталог |
| Поиск по глобальному каталогу Apple Music (песни, альбомы, исполнители, плейлисты). |
| Находит точный студийный аудио-ID в каталоге по названию/исполнителю. | |
| Получайте лучшие песни любого исполнителя. | |
| Получайте треки из официальных курируемых плейлистов Apple ( | |
Воспроизведение |
| Управление плеером ( |
| Обнаружение доступных колонок AirPlay и HomePod. | |
Курирование |
| Удаляет видеоэлементы и заменяет их официальными студийными аудиотреками. |
| Дедупликация изданий плейлистов с сохранением канонических треков. | |
| Объединение плейлистов со 100% дедупликацией. |
💻 Команды CLI
# Check status & active tokens
apple-music-mcp status
# Extract authentication tokens from open Safari session
apple-music-mcp login
# Clear catalog cache
apple-music-mcp clean-cache
# Run MCP server over stdio
apple-music-mcp serve🏷️ Теги и обнаружение
#ModelContextProtocol #MCP #MCPServer #AppleMusic #ClaudeAI #CursorAI #AnthropicClaude #AIAgents #MusicKit #Spotify #Shazam #YouTubeMusic #AppleScript #Python #OpenSource #DeveloperTools #LLM #Automation #PlaylistGenerator
📄 Лицензия
MIT © saitarrun
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
MCP connector for iMessage & Contacts via a local Mac agent + Vercel relay
Spotify MCP server for ChatGPT, Claude and any AI agent: search songs and artists, list playlists, read playlist songs, create playlist, add songs to playlist, remove songs from playlist, set playlist public or private and save to Liked Songs in your own Spotify account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Spotify yourself; Cotlet does not store your password and you need no Spotify API key. About the official Spotify API: Spotify has a full Web API and, since 23 Apr 2026, an official connector for Claude (checked 5 Nov 2026). The API needs an app you register, and in development mode the app owner must have Premium and the app allows 5 users; unlimited users need a registered business with at least 250,000 monthly users. Setup and FAQ: https://cotlet.dev/integrations/spotify-api-mcp-server
MCP connector that lets ChatGPT list, search, and run your Apple Shortcuts via a local Mac agent
Search, read, and write your Apple Notes from ChatGPT/Claude via a local Mac agent + MCP relay.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceMCP server for controlling Apple Music on macOS using JXA (JavaScript for Automation). Manage playback, search tracks, create playlists, and more without API keys.14 npmMIT
- AlicenseBqualityBmaintenanceThe ultimate 66-tool Apple Music MCP server for macOS: playback, Spotify playlist importer, listening journal, Replay reports, smart DJ crossfades, and AirPlay.663MIT
- FlicenseNot gradedqualityAmaintenanceGives MCP clients control of Apple Music playlists, library, catalog, discovery, playback, and the Up Next queue, using four interchangeable engines that run on macOS, Windows, and Linux. Requires only a Mac or an Apple Music subscription, with the API engine needing no browser or Music app at all.-
- FlicenseNot gradedqualityAmaintenanceEnables any MCP client to control Apple Music playlists, library, catalog, discovery, playback, and the Up Next queue on macOS, Windows, and Linux using selectable native, API, Safari, or Chrome engines. Provides catalog and library search, playlist and folder management, ratings and favorites, playback controls, queue management, AirPlay selection, and cross-platform support with or without an Apple Music subscription.-