MCP-애플뮤직
AppleScript 명령을 통해 macOS에서 Apple Music(이전 iTunes)을 제어하기 위한 FastMCP 서버 구현입니다.
요구 사항
파이썬 3.13+
Apple Music 앱이 설치된 macOS
MCP 라이브러리 ≥1.2.1
Related MCP server: MCP Browser Tabs Server
설치
먼저, UV가 설치되어 있는지 확인하세요.
지엑스피1
그런 다음 Claude Desktop을 사용하여 claude_desktop_config.json 에 다음을 추가합니다.
{
"mcpServers": {
"iTunesControlServer": {
"command": "uvx",
"args": ["-n", "mcp-applemusic"]
}
}
}
사용 가능한 명령
다음 명령은 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
용법
서버를 시작합니다:
python server.py
상호작용 예시:
# 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")
개발
저장소를 복제합니다.
git clone https://github.com/yourusername/mcp-applemusic.git
cd mcp-applemusic
개발 종속성 설치:
pip install -e ".[dev]"
기여하다
저장소를 포크하세요
기능 브랜치를 생성합니다(
git checkout -b feature/amazing-feature)변경 사항을 커밋하세요(
git commit -m 'Add amazing feature')브랜치에 푸시(
git push origin feature/amazing-feature)풀 리퀘스트 열기
특허
이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.
노트
이 도구는 AppleScript 종속성으로 인해 macOS 시스템에서만 작동합니다.
Apple Music(이전 iTunes)이 설치되어 있어야 합니다.