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

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

MCP Spotify Server
superseoworld
A
security
A
license
A
quality
Enables interaction with Spotify's music catalog via the Spotify Web API, supporting searches, artist information retrieval, playlist management, and automatic token handling.
Last updated -
26
547
2
TypeScript
MIT License
Apple MCP Server
supermemoryai
A
security
A
license
A
quality
Enables interaction with Apple apps like Messages, Notes, and Contacts through the MCP protocol to send messages, search, and open app content using natural language.
Last updated -
6
628
1,692
TypeScript
MIT License
Spotify MCP Server
obre10off
-
security
-
license
-
quality
A Model Context Protocol server that enables controlling Spotify playback through natural language commands in MCP clients like Cursor or Claude for Desktop.
Last updated -
1
TypeScript
Spotify MCP Server
rakshitha2207
-
security
F
license
-
quality
Integrates with Spotify Web API through the Model Context Protocol, allowing users to search tracks, control playback, and manage playlists programmatically.
Last updated -
JavaScript

View all related MCP servers

MCP-AppleMusic