local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Enables control of Apple Music on macOS through AppleScript commands, including playback control, library search, song selection, and playlist creation.
Provides legacy support for controlling iTunes through AppleScript commands, offering functionality for playback control, library management, searching, and playlist creation.
Leverages macOS-specific AppleScript capabilities to enable music playback control and library management for Apple Music/iTunes applications.

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

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

Clonar el repositorio:

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

Instalar dependencias de desarrollo:

pip install -e ".[dev]"

Contribuyendo

Bifurcar el repositorio
Crea tu rama de funciones ( git checkout -b feature/amazing-feature )
Confirme sus cambios ( git commit -m 'Add amazing feature' )
Empujar a la rama ( git push origin feature/amazing-feature )
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)

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

Facilita el control de Apple Music en macOS a través de AppleScript mediante comandos MCP, lo que permite a los usuarios administrar la reproducción, buscar pistas y crear listas de reproducción.

Related Resources

Reddit Discussion about this server