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: MCP Browser Tabs 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

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)