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

license - permissive license

quality - not tested

How are these scores calculated?

local-only server

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

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

Related Resources

Reddit Discussion about this server

Related MCP Servers

Apple Shortcuts Server
recursechat
A
security
A
license
A
quality
An MCP Server Integration with Apple Shortcuts
Last updated -
2
63
214
JavaScript
Apache 2.0
MCP Browser Tabs Server
kazuph
A
security
A
license
A
quality
Enables interaction with Google Chrome tabs through the MCP protocol, allowing clients to retrieve information and control tabs on macOS using AppleScript.
Last updated -
2
349
8
JavaScript
MIT License
macOS Defaults MCP Server
g0t4
A
security
F
license
A
quality
MCP server that enables reading and writing macOS system preferences and application settings through the defaults system.
Last updated -
4
11
Python
Apple MCP
zackbissell
-
security
A
license
-
quality
A collection of Apple-native tools for the MCP protocol that enables AI assistants to interact with Apple applications including Messages, Notes, Contacts, Mail, Reminders, Calendar, and Maps.
Last updated -
123
TypeScript
MIT License

View all related MCP servers

MCP-AppleMusic