오디오 플레이어 MCP 서버

Claude가 사용자 컴퓨터의 오디오 재생을 제어할 수 있게 해주는 MCP(Model Context Protocol) 서버입니다.

특징

• MP3, WAV, OGG 오디오 파일을 재생합니다.
• 음악 디렉토리에서 사용 가능한 오디오 파일을 나열하세요.
• 오디오 재생을 중지합니다.
• 디렉토리 격리를 통해 파일 액세스를 보호합니다.

요구 사항

• Python 3.10 이상.
• 클로드 데스크톱 (최신 버전).

설치

1. 저장소를 복제합니다.지엑스피1
2. 저장소 디렉토리로 이동합니다.
   cd audio-player-mcp
3. 편집 가능한 모드로 패키지를 설치하세요:
   pip install -e .

Claude Desktop으로 설정

1. Claude Desktop 설정을 열고 다음으로 이동합니다.
   Developer > Edit Config
2. 구성 파일을 찾으세요.
   • Mac : ~/Library/Application Support/Claude/claude_desktop_config.json
   • 윈도우 : %APPDATA%\Claude\claude_desktop_config.json
3. 운영 체제에 따라 다음 구성을 추가하세요.맥/리눅스:
   { "mcpServers": { "audio-player": { "command": "/path/to/your/venv/bin/python", "args": [ "/path/to/your/audio-player-mcp/src/audio_player_mcp/player.py" ], "env": { "AUDIO_PLAYER_DIR": "/path/to/your/audio/files" } } } }
   윈도우:
   { "mcpServers": { "audio-player": { "command": "C:\path\to\your\venv\Scripts\python.exe", "args": [ "C:\path\to\your\audio-player-mcp\src\audio_player_mcp\player.py" ], "env": { "AUDIO_PLAYER_DIR": "C:\path\to\your\audio\files" } } } }
   참고: AUDIO_PLAYER_DIR 설정되지 않으면 서버는 기본적으로 홈 디렉토리의 Music 폴더를 사용합니다.
4. Claude Desktop을 다시 시작합니다.

용법

이제 Claude에게 다음과 같이 질문하여 오디오 재생을 제어할 수 있습니다.

• "내가 가지고 있는 오디오 파일은 뭐죠?"
• "노래.mp3 재생."
• "음악을 멈춰요."

문제 해결

문제가 있는 경우 Claude의 로그를 확인하세요.

• 스코틀랜드 사람:
  tail -f ~/Library/Logs/Claude/mcp*.log
• 윈도우:
  type "%APPDATA%\Claude\logs\mcp*.log"

개발

1. 저장소를 복제합니다.
   git clone https://github.com/yourusername/audio-player-mcp.git
2. 저장소 디렉토리로 이동합니다.
   cd audio-player-mcp
3. 개발 종속성 설치:
   pip install -e ".[dev]"
4. 개발 모드에서 MCP 서버를 실행합니다.
   mcp dev src/audio_player_mcp/player.py

특허

이 프로젝트는 MIT 라이선스 에 따라 라이선스가 부여되었습니다.