MCP 사운드 도구

Cursor AI 및 기타 MCP 호환 환경에서 사운드 효과를 재생하는 모델 컨텍스트 프로토콜(MCP) 구현입니다. 이 Python 구현은 더욱 인터랙티브한 코딩 경험을 위해 오디오 피드백을 제공합니다.

특징

다양한 이벤트(완료, 오류, 알림)에 대한 사운드 효과를 재생합니다.
Cursor 및 기타 IDE와의 표준화된 통합을 위해 MCP(Model Context Protocol)를 사용합니다.
크로스 플랫폼 지원(Windows, macOS, Linux)
구성 가능한 사운드 효과

설치

Python 버전 호환성

이 패키지는 Python 3.8~3.11에서 테스트되었습니다. Python 3.12 이상에서 오류(특히 BrokenResourceError 또는 TaskGroup 예외)가 발생하는 경우 이전 Python 버전을 사용해 보세요.

권장사항: pipx로 설치

mcp-sound-tool을 설치하는 데 권장되는 방법은 pipx를 사용하는 것입니다. 이 방법을 사용하면 패키지를 격리된 환경에 설치하면서 동시에 명령을 전역적으로 사용할 수 있습니다.

지엑스피1

이 방법을 사용하면 도구가 자체적으로 격리된 환경을 갖도록 하여 다른 패키지와의 충돌을 피할 수 있습니다.

대안: pip로 설치

pip를 사용하여 직접 설치할 수도 있습니다.

pip install mcp-sound-tool

출처에서

이 저장소를 복제하세요:
git clone https://github.com/yourusername/mcp-sound-tool cd mcp-sound-tool
소스 디렉토리에서 pipx로 직접 설치:
pipx install .
또는 pip를 사용하면:
pip install -e .

용법

사운드 파일 추가

사운드 파일을 sounds 디렉터리에 넣으세요. 다음과 같은 사운드 파일이 필요합니다.

completion.mp3 - 코드 생성 후 재생됨
error.mp3 - 오류 발생 시 재생됩니다.
notification.mp3 - 일반 알림에 사용됨

freesound.org와 같은 웹사이트에서 무료 음향 효과를 찾을 수 있습니다.

MCP 서버 실행

MCP 서버를 실행합니다.

mcp-sound-tool

서버는 stdio 전송을 통해 Cursor 또는 다른 MCP 호환 클라이언트에서 이벤트를 시작하고 수신합니다.

커서의 구성

이 서버를 Cursor와 함께 사용하려면 MCP 구성 파일에 추가하세요.

macOS에서:

// ~/Library/Application Support/Cursor/mcp.json
{
  "mcpServers": {
    "sound": {
      "command": "mcp-sound-tool",
      "args": [],
      "type": "stdio",
      "pollingInterval": 5000,
      "startupTimeout": 10000,
      "restartOnFailure": true
    }
  }
}

Windows의 경우:

// %APPDATA%/Cursor/mcp.json
{
  "mcpServers": {
    "sound": {
      "command": "mcp-sound-tool",
      "args": [],
      "type": "stdio",
      "pollingInterval": 5000,
      "startupTimeout": 10000,
      "restartOnFailure": true
    }
  }
}

pipx 와 함께 설치하면 mcp-sound-tool 명령을 PATH에서 사용할 수 있으므로 Cursor는 전체 경로를 지정하지 않고도 해당 명령을 찾아 실행할 수 있습니다.

AI 모델을 위한 Sound MCP 사용 지침

이 MCP 서버는 AI 상호작용을 위한 오디오 피드백 기능을 제공합니다. 사용자가 텍스트를 읽지 않고도 작업 상태를 명확하게 나타내는 오디오 신호를 제공하여 사용자 경험을 향상시키도록 설계되었습니다.

사운드 피드백을 사용하는 경우

AI 에이전트는 적절한 순간에 적극적으로 사운드 도구를 활용해야 합니다.

성공 사운드( completion ) :
- 작업이나 명령이 성공적으로 완료된 후
- 중요한 작업이 성공적으로 완료되었을 때
- 사용자의 요청이 이행되었음을 확인할 때
오류 소리( error ) :
- 명령이 실패하거나 오류가 발생한 경우
- 사용자에게 문제에 대해 경고할 때
- 요청한 대로 작업을 완료할 수 없는 경우
알림음( notification ) :
- 사용자에게 중요한 정보를 알릴 때
- 사용자의 주의나 입력을 요청할 때
- 장기 실행 작업에 대한 상태 업데이트

사용 예

# When a command completes successfully
@mcp.tool()
def execute_command(command):
    result = run_command(command)
    if result.success:
        play_sound("completion")  # Indicate success with audio
        return "Command executed successfully"
    else:
        play_sound("error")  # Indicate failure with audio
        return f"Error: {result.error_message}"

사용 가능한 도구

play_sound(sound_type="completion", custom_sound_path=None) : 사운드 효과를 재생합니다.
list_available_sounds() : 사용 가능한 모든 사운드 파일을 나열합니다.
install_to_user_dir() : 사용자의 config 디렉토리에 사운드 파일을 설치합니다.

자세한 내용을 알아보려면 MCP 서버에 연결하여 도구 설명을 확인하세요.

개발

개발을 위해:

# Install development dependencies
pip install -e ".[dev]"

# Run tests
pytest

감사의 말

이 Python 버전에 영감을 준 원래의 sound-mcp JavaScript 구현을 만든 SIAM-TheLegend
AI 도구 상호 작용을 위한 강력한 표준을 만드는 MCP 프로토콜 개발자
테스트 및 문서화에 기여한 사람들

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

MCP Sound Tool