Windows System Sounds MCP Server

Ein MCP-Server für Windows, der die in Windows integrierten Systemklänge oder vorhandene WAV-Dateien abspielt.

Er kann mit LM Studio oder einem anderen MCP-kompatiblen Client verwendet werden, um den Benutzer zu benachrichtigen, wenn ein lokales Modell eine Phase abgeschlossen hat, Aufmerksamkeit benötigt, eine Berechtigung anfordert oder die gesamte Aufgabe erledigt hat.

Der Server verwendet das Windows-Standardmodul winsound; zusätzliche Audiodateien müssen nicht heruntergeladen werden.

Funktionen

• Ein MCP-Tool: play_sound.

• Zwei integrierte Voreinstellungen:

  • attention — Phase abgeschlossen, Benutzeraufmerksamkeit erforderlich oder Berechtigung angefordert.

  • done — gesamte Aufgabe abgeschlossen.

• Spielt WAV-Dateien aus dem Windows-Media-Ordner ab:

  • %SystemRoot%\Media

• Spielt WAV-Dateien über den vollständigen Pfad ab:

  • C:/my-sounds/my_sound.wav

• Wiederholt einen Sound mehrmals.

• Pause zwischen den Wiederholungen: 3 Sekunden.

• Standardmäßig minimale diagnostische stderr-Ausgabe.

• Optionale Debug-Protokollierung über SOUND_MCP_DEBUG.

Voraussetzungen

• Windows

• Python 3.10 oder neuer

• LM Studio oder ein anderer MCP-Client

• Python-Paket mcp

Installation

Installieren Sie das MCP-SDK:

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

Speichern Sie sound_mcp_server.py in einen Ordner, zum Beispiel:

C:\mcp\sound_mcp_server.py

LM Studio-Konfiguration

Beispielkonfiguration für den MCP-Server:

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

Ersetzen Sie den Python-Pfad und den Skriptpfad durch Ihre tatsächlichen Pfade.

Führen Sie den folgenden Befehl aus, um den Pfad zu Ihrer Python-Datei zu finden:

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

Starten Sie LM Studio neu, nachdem Sie den Server hinzugefügt haben.

Tool: play_sound

Der Server stellt genau ein Tool bereit:

play_sound

Parametros

Mindestens eine Tonquelle muss angegeben werden:

• sound_type

• oder system_file

• oder full_path

Wenn sowohl system_file als auch full_path angegeben sind, gibt der Server einen Fehler zurück.

Beispiele

Voreinstellung „attention“

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

En Voreinstellung „done“

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

Eine Datei aus dem Windows-Media-Ordner abspielen

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

Eine Datei über den vollständigen Pfad abspielen

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

Einen Sound dreimal wiederholen

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

Wiedergabereihenfolge:

play
pause 3 seconds
play
pause 3 seconds
play

Nach der letzten Wiederholung wird keine zusätzliche Pause eingefügt.

Protokollierung

Der Server erzeugt standardmäßig minimale diagnostische stderr-Ausgaben.

Die Debug-Protokollierung kann über die Umgebungsvariable aktiviert werden:

SOUND_MCP_DEBUG=1

Beispielkonfiguration für LM Studio mit Debug-Protokollierung:

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

Einige MCP-Clients, einschließlich LM Studio, können die stderr-Ausgabe des MCP-Servers als [ERROR] anzeigen, auch wenn die Meldung nur diagnostisch ist.

Sicherheitshinweise

Der Parameter full_path kann beliebige WAV-Dateien auf dem lokalen System abspielen.

Für die lokale, persönliche Nutzung ist das in der Regel in Ordnung.

Falls der Server nicht zwei umg nur umgibt es besser nicht:

• Entfernen Sie die Unterstützung für full_path.

• oder erlauben Sie nur bestimmte Verzeichnisse.

• oder verwenden Sie ausschließlich system_file.

Einschränkungen

• Nur Windows.

• Es werden nur .wav-Dateien unterstützt.

• system_file akzeptiert nur einen Dateinamen und keinen Ordnerpfad.

• full_path muss ein absoluter Pfad zu einer vorhandenen Datei sein.

Empfohlener System-Prompt

Damit das lokale Modell das Werkzeug automatisch verwendet, fügen Sie die folgende Anleitung zu Ihrem System-Prompt in LM Studio hinzu:

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")

(Diesen Prompt finden Sie auch in der Datei examples/prompts.md.)

Lizenz

MIT. Siehe License.