local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Enables control of Apple Music on macOS through AppleScript commands, including playback control, library search, song selection, and playlist creation.
Provides legacy support for controlling iTunes through AppleScript commands, offering functionality for playback control, library management, searching, and playlist creation.
Leverages macOS-specific AppleScript capabilities to enable music playback control and library management for Apple Music/iTunes applications.

MCP-애플뮤직

AppleScript 명령을 통해 macOS에서 Apple Music(이전 iTunes)을 제어하기 위한 FastMCP 서버 구현입니다.

요구 사항

파이썬 3.13+
Apple Music 앱이 설치된 macOS
MCP 라이브러리 ≥1.2.1

설치

먼저, 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)이 설치되어 있어야 합니다.

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

MCP 명령을 사용하여 AppleScript를 통해 macOS에서 Apple Music을 제어할 수 있도록 하여 사용자가 재생을 관리하고, 트랙을 검색하고, 재생 목록을 만들 수 있도록 합니다.

Related Resources

Reddit Discussion about this server

MCP-AppleMusic