Sound

Sound는 Claude Code, Cursor, Windsurf와 같은 AI 도구가 자연어를 통해 Apple Music을 검색, 재생 및 관리할 수 있도록 하는 macOS 네이티브 MCP 서버입니다.

API 키도, 브라우저 인증 흐름도 필요 없습니다. 명령어 한 줄로 설치하고, 프롬프트 한 번으로 설정하세요.

주요 기능

요구 사항

• Apple Silicon 기반 macOS 14 이상 (Sonoma 이상)

• Apple Music 구독 (재생용; 카탈로그 검색은 구독 없이도 가능)

• MCP 호환 AI 도구 (Claude Code, Cursor, Windsurf 등)

• 소스에서 빌드 시: Xcode 16.3+ / Swift 6.1+

설치

Homebrew (권장)

brew install seayniclabs/tap/sound

소스에서 빌드

git clone https://github.com/seayniclabs/sound.git
cd sound
swift build -c release
codesign --force --sign - --entitlements Sources/Sound/Sound.entitlements .build/release/Sound

바이너리는 .build/release/Sound에 있습니다.

최초 설정

Apple Music 접근 권한을 부여하려면 설정 명령어를 실행하세요:

sound setup

이 명령어를 실행하면 macOS 권한 프롬프트가 나타납니다. 이 작업은 한 번만 수행하면 됩니다.

Claude Code에 추가

claude mcp add sound -- $(which sound)

또는 ~/.claude.json에 수동으로 추가하세요:

{
  "mcpServers": {
    "sound": {
      "command": "/path/to/sound",
      "args": ["serve"]
    }
  }
}

사용법

연결이 완료되면 AI 도구에 다음과 같이 말해보세요:

• "Apple Music에서 Tycho 검색해줘"

• "Foo Fighters의 Everlong 재생해줘"

• "Focus라는 재생 목록을 만들고 이 트랙들을 추가해줘"

• "지금 뭐 재생 중이야?"

• "다음 트랙으로 넘겨줘"

작동 원리

Sound는 Apple의 MusicKit 프레임워크를 사용하여 macOS에서 Apple Music과 네이티브로 상호 작용합니다. Model Context Protocol(JSON-RPC)을 사용하여 stdio를 통해 AI 도구와 통신합니다.

AI Tool  --stdio/JSON-RPC-->  Sound  --MusicKit-->  Apple Music
                                     --ApplicationMusicPlayer-->  Music.app

인증은 macOS에서 처리됩니다. 바이너리에는 번들 식별자(com.seayniclabs.sound)와 MusicKit 권한이 포함되어 있습니다. 사용자는 프롬프트가 나타나면 "허용"을 클릭하기만 하면 됩니다. 토큰, 새로 고침 로직, 설정 파일은 필요 없습니다.

빌드

swift build           # debug build
swift build -c release  # release build

Sound는 Swift 6.1 이상이 필요하며 macOS 14 이상을 대상으로 합니다.

라이선스

MIT

크레딧

Seaynic Labs에서 제작.