MCP-AppleMusic

Una implementación de servidor FastMCP para controlar Apple Music (anteriormente iTunes) en macOS a través de comandos AppleScript.

Requisitos

• Python 3.13+

• macOS con la aplicación Apple Music instalada

• Biblioteca MCP ≥1.2.1

Related MCP server: Apple Music MCP Server

Instalación

Primero, asegúrese de tener instalado el protector UV:

$ brew install uv

Luego, con Claude Desktop , agregue lo siguiente a claude_desktop_config.json :

{
  "mcpServers": {
    "iTunesControlServer": {
      "command": "uvx",
      "args": ["-n", "mcp-applemusic"]
    }
  }
}

Comandos disponibles

Los siguientes comandos están disponibles a través del servidor MCP:

itunes_play()         # Start playback
itunes_pause()        # Pause playback
itunes_next()         # Skip to next track
itunes_previous()     # Go to previous track
itunes_search(query)  # Search library for tracks
itunes_play_song(song)  # Play specific song
itunes_create_playlist(name, songs)  # Create new playlist
itunes_library()      # Get library statistics

Uso

Iniciar el servidor:

python server.py

Ejemplos de interacciones:

# Search for a song
results = itunes_search("Hey Jude")

# Create a new playlist
itunes_create_playlist("Beatles Favorites", ["Yesterday", "Hey Jude", "Let It Be"])

# Play a specific song
itunes_play_song("Hey Jude")

Desarrollo

1. Clonar el repositorio:

git clone https://github.com/yourusername/mcp-applemusic.git
cd mcp-applemusic

2. Instalar dependencias de desarrollo:

pip install -e ".[dev]"

Contribuyendo

1. Bifurcar el repositorio

2. Crea tu rama de funciones ( git checkout -b feature/amazing-feature )

3. Confirme sus cambios ( git commit -m 'Add amazing feature' )

4. Empujar a la rama ( git push origin feature/amazing-feature )

5. Abrir una solicitud de extracción

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Notas

• Esta herramienta solo funciona en sistemas macOS debido a su dependencia de AppleScript

• Requiere que tenga instalado Apple Music (anteriormente iTunes)