mirror of
https://github.com/kennethreitz/mcp-applemusic.git
synced 2026-06-21 06:50:57 +00:00
82 lines
1.7 KiB
Markdown
82 lines
1.7 KiB
Markdown
# MCP-AppleMusic
|
|
|
|
A FastMCP server implementation for controlling Apple Music (formerly iTunes) on macOS through AppleScript commands.
|
|
|
|
## Requirements
|
|
|
|
- Python 3.13+
|
|
- macOS with Apple Music app installed
|
|
- MCP library ≥1.2.1
|
|
|
|
## Installation
|
|
|
|
```bash
|
|
pip install mcp-applemusic
|
|
```
|
|
|
|
## Available Commands
|
|
|
|
The following commands are available through the MCP server:
|
|
|
|
```python
|
|
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
|
|
```
|
|
|
|
## Usage
|
|
|
|
Start the server:
|
|
|
|
```bash
|
|
python server.py
|
|
```
|
|
|
|
Example interactions:
|
|
|
|
```python
|
|
# 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")
|
|
```
|
|
|
|
## Development
|
|
|
|
1. Clone the repository:
|
|
```bash
|
|
git clone https://github.com/yourusername/mcp-applemusic.git
|
|
cd mcp-applemusic
|
|
```
|
|
|
|
2. Install development dependencies:
|
|
```bash
|
|
pip install -e ".[dev]"
|
|
```
|
|
|
|
## Contributing
|
|
|
|
1. Fork the repository
|
|
2. Create your feature branch (`git checkout -b feature/amazing-feature`)
|
|
3. Commit your changes (`git commit -m 'Add amazing feature'`)
|
|
4. Push to the branch (`git push origin feature/amazing-feature`)
|
|
5. Open a Pull Request
|
|
|
|
## License
|
|
|
|
This project is licensed under the MIT License - see the LICENSE file for details.
|
|
|
|
## Notes
|
|
|
|
- This tool only works on macOS systems due to its AppleScript dependency
|
|
- Requires Apple Music (formerly iTunes) to be installed
|