Skip to main content
Glama
deenesjakoruzh
saitarrun

apple_music_mcp

by saitarrun
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

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.git

Related MCP server: apple-music-mcp

🔌 Настройка MCP-клиента

Добавьте apple-music в вашего любимого ИИ-ассистента за считанные секунды:

1. Antigravity / AGY CLI

agy mcp add apple-music -- npx -y @saitarrunpitta/apple-music-mcp

2. 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-ключей.

  • 🧠 Умные рекомендации: Рекомендации треков в реальном времени на основе вашей истории прослушивания и схожести исполнителей.

🛠️ Справочник инструментов

Категория

Инструмент

Описание

Обнаружение

apple_music_get_cross_platform_charts

Получайте главные хиты из чартов Shazam, Spotify, YouTube или Apple Music.

apple_music_populate_from_charts

Наполняйте плейлист напрямую из любого чарта с дедупликацией.

apple_music_get_music_recommendations

Умные рекомендации на основе истории прослушивания и исполнителей.

apple_music_get_recently_played

Получайте недавнюю историю прослушивания из облака Apple Music.

apple_music_get_heavy_rotation

Получайте самые часто воспроизводимые альбомы и плейлисты.

Плейлисты

apple_music_list_playlists

Список всех плейлистов библиотеки с количеством треков и описаниями.

apple_music_get_playlist_tracks

Быстрое массовое получение треков (название, исполнитель, альбом, длительность).

apple_music_add_tracks_to_playlist

Параллельное пакетное добавление без дубликатов.

apple_music_remove_tracks_from_playlist

Массовое удаление по ID связей треков.

apple_music_create_playlist

Создание нового плейлиста с произвольным описанием.

apple_music_delete_playlist

Безопасное удаление плейлиста без удаления песен из библиотеки.

apple_music_set_playlist_description

Обновление описания плейлиста и синхронизация с iCloud.

Каталог

apple_music_search_catalog

Поиск по глобальному каталогу Apple Music (песни, альбомы, исполнители, плейлисты).

apple_music_resolve_song

Находит точный студийный аудио-ID в каталоге по названию/исполнителю.

apple_music_get_artist_top_songs

Получайте лучшие песни любого исполнителя.

apple_music_get_catalog_playlist_tracks

Получайте треки из официальных курируемых плейлистов Apple (pl.xxx).

Воспроизведение

apple_music_playback_control

Управление плеером (play, pause, skip, volume, shuffle, rate, love).

apple_music_airplay_devices

Обнаружение доступных колонок AirPlay и HomePod.

Курирование

apple_music_curation_clean_videos

Удаляет видеоэлементы и заменяет их официальными студийными аудиотреками.

apple_music_curation_deduplicate

Дедупликация изданий плейлистов с сохранением канонических треков.

apple_music_curation_merge_playlists

Объединение плейлистов со 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. Dates show when Glama detected each change.

No tool schema history has been recorded yet.

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/saitarrun/apple-music-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server