Skip to main content
Glama
saitarrun

apple_music_mcp

Apple Music MCP

Un servidor Model Context Protocol (MCP) de alto rendimiento para Apple Music. Motor dual nativo de macOS JXA y REST en la nube con descubrimiento multiplataforma, procesamiento por lotes asíncrono y ejecución sin tiempo de espera.


⚡ Inicio rápido

Ejecuta al instante con npx o uvx (sin instalación necesaria):

Opción A: Usar npx (Recomendado)

npx -y @saitarrunpitta/apple-music-mcp

Opción B: Usar uvx

uvx --from git+https://github.com/saitarrun/apple-music-mcp.git apple-music-mcp serve

Opción C: Instalar localmente mediante npm o 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

🔌 Configuración del cliente MCP

Añade apple-music a tu asistente de IA preferido en segundos:

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

✨ Características de un vistazo

  • ⚡ Motor JXA sin tiempo de espera: Lee listas de reproducción con más de 1000 canciones en menos de 100 ms sin bloqueos de AppleScript.

  • 🌐 Listas de éxitos multiplataforma: Fuentes de descubrimiento directas de Shazam, Spotify, YouTube y Apple Music.

  • 🚀 Procesamiento por lotes asíncrono en paralelo: Añade o elimina más de 100 canciones en paralelo en menos de 1 segundo.

  • 🎵 Garantía de audio puro: Filtra automáticamente los vídeos musicales y los vídeos con letra para mantener las listas de reproducción en audio puro.

  • 🛡️ Prevención de duplicados al 100%: El emparejamiento difuso integrado evita añadir canciones duplicadas.

  • 🔐 Autenticación automática con Safari: Extrae sin problemas los tokens del reproductor web de Safari sin necesidad de claves de API manuales.

  • 🧠 Recomendaciones inteligentes: Sugerencias de canciones en tiempo real basadas en tu historial de escucha y en la similitud entre artistas.


🛠️ Referencia de herramientas

Categoría

Herramienta

Descripción

Descubrimiento

apple_music_get_cross_platform_charts

Obtén los mayores éxitos de las listas de Shazam, Spotify, YouTube o Apple Music.

apple_music_populate_from_charts

Rellena una lista de reproducción directamente desde cualquier lista con deduplicación.

apple_music_get_music_recommendations

Recomendaciones inteligentes basadas en el historial de escucha y en los artistas.

apple_music_get_recently_played

Obtén el historial de escucha reciente de la nube de Apple Music.

apple_music_get_heavy_rotation

Obtén los álbumes y las listas de reproducción más reproducidos.

Listas de reproducción

apple_music_list_playlists

Enumera todas las listas de reproducción de la biblioteca con el número de canciones y descripciones.

apple_music_get_playlist_tracks

Recuperación masiva y rápida de canciones (título, artista, álbum, duración).

apple_music_add_tracks_to_playlist

Adición por lotes en paralelo sin duplicados.

apple_music_remove_tracks_from_playlist

Eliminación masiva de IDs de relación de canciones.

apple_music_create_playlist

Crea una nueva lista de reproducción con descripción personalizada.

apple_music_delete_playlist

Elimina la lista de reproducción de forma segura sin quitar canciones de la biblioteca.

apple_music_set_playlist_description

Actualiza la descripción de la lista de reproducción y sincronízala con iCloud.

Catálogo

apple_music_search_catalog

Busca en el catálogo global de Apple Music (canciones, álbumes, artistas, listas de reproducción).

apple_music_resolve_song

Fija el ID de catálogo de audio de estudio exacto para el título/artista.

apple_music_get_artist_top_songs

Obtén las canciones mejor valoradas de cualquier artista.

apple_music_get_catalog_playlist_tracks

Obtén canciones de listas de reproducción oficiales seleccionadas por Apple (pl.xxx).

Reproducción

apple_music_playback_control

Controla el reproductor (play, pause, skip, volume, shuffle, rate, love).

apple_music_airplay_devices

Descubre los altavoces AirPlay y HomePods disponibles.

Curación

apple_music_curation_clean_videos

Elimina las entidades de vídeo y sustitúyelas por canciones oficiales de audio de estudio.

apple_music_curation_deduplicate

Deduplica las ediciones de las listas de reproducción, conservando las canciones canónicas.

apple_music_curation_merge_playlists

Combina listas de reproducción con deduplicación al 100%.


💻 Comandos 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

🏷️ Etiquetas y visibilidad

#ModelContextProtocol #MCP #MCPServer #AppleMusic #ClaudeAI #CursorAI #AnthropicClaude #AIAgents #MusicKit #Spotify #Shazam #YouTubeMusic #AppleScript #Python #OpenSource #DeveloperTools #LLM #Automation #PlaylistGenerator


📄 Licencia

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.

Maintenance

ActivityMaintained
ResponsivenessNo issues

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