Windows System Sounds MCP Server

Windows용 MCP 서버로, 기본 제공되는 Windows 시스템 사운드 또는 기존 WAV 파일을 재생합니다.

LM Studio 또는 MCP 호환 클라이언트와 함께 사용하여 로컬 모델이 특정 단계를 완료했을 때, 사용자의 주의가 필요할 때, 권한을 요청할 때, 또는 전체 작업을 완료했을 때 사용자에게 알릴 수 있습니다.

서버는 표준 Windows winsound 모듈을 사용하며 추가 오디오 파일을 다운로드할 필요가 없습니다.

기능

• MCP 도구 하나: play_sound.

• 기본 제공 프리셋 두 개:

  • attention — 단계 완료, 사용자 주의 필요, 또는 권한 요청.

  • done — 전체 작업 완료.

• Windows Media 폴더에서 WAV 파일 재생:

  • %SystemRoot%\Media

• 전체 경로로 WAV 파일 재생:

  • C:/my-sounds/my_sound.wav

• 소리를 여러 번 반복합니다.

• 반복 사이 대기 시간: 3초.

• • 기본적으로 최소한의 진단 stderr 출력.

• SOUND_MCP_DEBUG를 통한 선택적 디버그 로깅.

요구 사항

• Windows

• Python 3.10 이상

• LM Studio 또는 다른 MCP 클라이언트

• mcp Python 패키지

설치

MCP SDK를 설치합니다:

python -m pip install --upgrade pip
python -m pip install "mcp[cli]"

sound_mcp_server.py를 폴더에 저장합니다. 예를 들어:

C:\mcp\sound_mcp_server.py

LM Studio 구성

MCP 서버 구성 예시:

{
  "mcpServers": {
    "windows-system-sounds": {
      "command": "C:\\Users\\YOUR_USERNAME\\AppData\\Local\\Programs\\Python\\Python312\\python.exe",
      "args": [
        "C:\\mcp\\sound_mcp_server.py"
      ]
    }
  }
}

Python 경로와 스크립트 경로를 실제 경로로 바꾸세요.

Python 실행 파일 경로를 찾으려면 다음을 실행하세요:

python -c "import sys; print(sys.executable)"

서버를 추가한 후 LM Studio를 다시 시작하세요.

도구: play_sound

서버는 하나의 도구를 제공합니다:

play_sound

매개변수

하나 이상의 사운드 소스를 지정해야 합니다:

• sound_type

• 또는 system_file

• 또는 full_path

system_file과 full_path를 모두 제공하면 서버는 오류를 반환합니다.

예제

Attention 프리셋

{
  "name": "play_sound",
  "arguments": {
    "sound_type": "attention"
  }
}

Done 프리셋

{
  "name": "play_sound",
  "arguments": {
    "sound_type": "done"
  }
}

Windows Media 폴더에서 파일 재생

{
  "name": "play_sound",
  "arguments": {
    "system_file": "Windows Notify Calendar.wav"
  }
}

전체 경로로 파일 재생

{
  "name": "play_sound",
  "arguments": {
    "full_path": "C:/my-sounds/my_sound.wav"
  }
}

소리를 세 번 반복

{
  "name": "play_sound",
  "arguments": {
    "system_file": "Windows Notify Calendar.wav",
    "repeat": 3
  }
}

재생 순서:

play
pause 3 seconds
play
pause 3 seconds
play

마지막 반복 이후에는 추가 대기 시간이 없습니다.

로깅

서버는 기본적으로 최소한의 진단 stderr 출력을 생성합니다.

디버그 로깅은 다음 환경 변수로 활성화할 수 있습니다:

SOUND_MCP_DEBUG=1

디버그 로깅이 포함된 LM Studio 구성 예시:

{
  "mcpServers": {
    "windows-system-sounds": {
      "command": "C:\\Users\\YOUR_USERNAME\\AppData\\Local\\Programs\\Python\\Python312\\python.exe",
      "args": [
        "C:\\mcp\\sound_mcp_server.py"
      ],
      "env": {
        "SOUND_MCP_DEBUG": "1"
      }
    }
  }
}

LM Studio를 포함한 일부 MCP 클라이언트는 메시지가 단순 진단용이더라도 MCP 서버의 stderr 출력을 [ERROR]로 표시할 수 있습니다.

보안 참고 사항

full_path 매개변수는 로컬 컴퓨터의 임의의 WAV 파일을 재생할 수 있습니다.

로컬 개인용으로는 보통 문제가 없습니다.

서버가 신뢰할 수 없는 클라이언트에 노출된 경우 다음을 고려하세요:

• full_path 지원 제거;

• 또는 특정 디렉터리만 허용;

• 또는 system_file만 사용.

제한 사항

• Windows 전용.

• .wav 파일만 지원됩니다.

• system_file은 폴더 경로가 아닌 파일 이름만 허용합니다.

• full_path는 존재하는 파일의 절대 경로여야 합니다.

권장 시스템 프롬프트

로컬 모델이 도구를 자동으로 사용하게 하려면 LM Studio 시스템 프롬프트에 다음 지침을 추가하세요:

When an important stage is finished or user permission is required, call:
play_sound(sound_type="attention")

When the whole job is fully finished, call:
play_sound(sound_type="done")

(이 프롬프트는 examples/prompts.md에서도 찾을 수 있습니다).

라이선스

MIT. LICENSE를 참조하세요.