Windows System Sounds MCP Server

Windows の組み込みシステムサウンドまたは既存の WAV ファイルを再生する Windows 用 MCP サーバー。

LM Studio やその他の MCP 互換クライアントで使用して、ローカルモデルがステージを完了したとき、注意が必要なとき、許可を要求したとき、またはタスク全体を完了したときに、ユーザーに通知できます。

このサーバーは標準の Windows winsound モジュールを使用するため、追加のオーディオファイルをダウンロードする必要はありません。

機能

• 1 つの MCP ツール: play_sound。

• 組み込みプリセットは 2 つ:

  • 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

サーバーは 1 つのツールを公開します:

play_sound

パラメーター

サウンドソースを少なくとも 1 つ指定する必要があります:

• 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"
  }
}

サウンドを 3 回繰り返す

{
  "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 を参照してください。