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

요구 사항

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

설치

첫째로, 당신은 uv가 설치한 것을 지킵니다:

그런 다음 Claude Desktop와 함께 다음 claude_desktop_config.json]에 추가하십시오.

사용 가능한 명령

다음 명령은 MCP 서버를 통해 사용할 수 있습니다.

사용법

서버 시작:

예제 상호 작용:

개발

1. 저장소를 복제:

2. 개발 의존도를 설치하십시오:

기여

1. 저장소를 포크
2. 기능 지점 만들기 (git checkout -b feature/amazing-feature)
3. 변경 (git commit -m 'Add amazing feature')
4. 지점에 푸시 (git push origin feature/amazing-feature)
5. 잡아당기기 요구를 여십시오

라이센스

이 프로젝트는 MIT 라이센스에 따라 라이센스가 부여됩니다 - 세부 사항에 대한 라이센스 파일을 참조하십시오.

노트

• 이 도구는 AppleScript 의존성 때문에 macOS 시스템에서만 작동합니다.
• Apple Music(이전 iTunes)를 설치해야 합니다

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

First, ensure you have uv installed:

$ brew install uv

Then, with Claude Desktop, add the following to claude_desktop_config.json:

{
  "mcpServers": {
    "iTunesControlServer": {
      "command": "uvx",
      "args": ["-p", "3.13", "-n", "mcp-applemusic"]
    }
  }
}

Available Commands

The following commands are available through the MCP server:

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:

python server.py

Example interactions:

# 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:

git clone https://github.com/yourusername/mcp-applemusic.git
cd mcp-applemusic

2. Install development dependencies:

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