mirror of
https://github.com/zhigang1992/mcp-applemusic.git
synced 2026-01-12 09:13:46 +08:00
Add initial project files and documentation for MCP-AppleMusic
This commit is contained in:
1
.python-version
Normal file
1
.python-version
Normal file
@@ -0,0 +1 @@
|
||||
3.13
|
||||
81
README.md
Normal file
81
README.md
Normal file
@@ -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
|
||||
9
pyproject.toml
Normal file
9
pyproject.toml
Normal file
@@ -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",
|
||||
]
|
||||
Reference in New Issue
Block a user