commit a937d4be5a959a8b4bac61cf59f10e8ba0f9af20 Author: Kenneth Reitz Date: Sat Feb 8 17:19:33 2025 -0500 Add initial project files and documentation for MCP-AppleMusic diff --git a/.python-version b/.python-version new file mode 100644 index 0000000..24ee5b1 --- /dev/null +++ b/.python-version @@ -0,0 +1 @@ +3.13 diff --git a/README.md b/README.md new file mode 100644 index 0000000..8d6936b --- /dev/null +++ b/README.md @@ -0,0 +1,81 @@ +# 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 diff --git a/pyproject.toml b/pyproject.toml new file mode 100644 index 0000000..473ad9c --- /dev/null +++ b/pyproject.toml @@ -0,0 +1,9 @@ +[project] +name = "mcp-applemusic" +version = "0.1.0" +description = "A simple Apple Music API client for MCP" +readme = "README.md" +requires-python = ">=3.13" +dependencies = [ + "mcp>=1.2.1", +]