Windows System Sounds MCP Server

Un servidor MCP para Windows que reproduce sonidos del sistema de Windows integrados o archivos WAV existentes.

Puede usarse con LM Studio o cualquier otro cliente compatible con MCP para notificar al usuario cuando un modelo local termina una etapa, necesita atención, solicita permiso o completa toda la tarea.

El servidor utiliza el módulo estándar winsound de Windows y no requiere descargar archivos de audio adicionales.

Características

• Una herramienta MCP: play_sound.

• Dos ajustes predefinidos integrados:

  • attention — etapa terminada, se necesita atención del usuario o se solicitó permiso.

  • done — trabajo completo terminado.

• Reproduce archivos WAV de la carpeta Windows Media:

  • %SystemRoot%\Media

• Reproduce archivos WAV por ruta completa:

  • C:/my-sounds/my_sound.wav

• Repite un sonido varias veces.

• Pausa entre repeticiones: 3 segundos.

• • Salida de diagnóstico stderr mínima de forma predeterminada.

• Registro de depuración opcional mediante SOUND_MCP_DEBUG.

Requisitos

• Windows

• Python 3.10 o más reciente

• LM Studio u otro cliente MCP

• Paquete Python mcp

Instalación

Instale el SDK de MCP:

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

Guarde sound_mcp_server.py en una carpeta, por ejemplo:

C:\mcp\sound_mcp_server.py

Configuración de LM Studio

Ejemplo de configuración del servidor MCP:

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

Reemplace la ruta de Python y la ruta del script con sus rutas reales.

Para encontrar la ruta de su ejecutable de Python, ejecute:

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

Reinicie LM Studio después de agregar el servidor.

Herramienta: play_sound

El servidor expone una herramienta:

play_sound

Parámetros

Debe especificarse al menos una fuente de sonido:

• sound_type

• o system_file

• o full_path

Si se proporcionan tanto system_file como full_path, el servidor devuelve un error.

Ejemplos

Ajuste predefinido de atención

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

Ajuste predefinido de finalización

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

Reproducir un archivo de la carpeta Windows Media

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

Reproducir un archivo por ruta completa

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

Repetir un sonido tres veces

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

Orden de reproducción:

play
pause 3 seconds
play
pause 3 seconds
play

No se agrega una pausa adicional después de la última repetición.

Registro

El servidor produce una salida de diagnóstico stderr mínima de forma predeterminada.

El registro de depuración se puede habilitar con la variable de entorno:

SOUND_MCP_DEBUG=1

Ejemplo de configuración de LM Studio con registro de depuración:

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

Algunos clientes MCP, incluido LM Studio, pueden mostrar la salida stderr del servidor MCP como [ERROR] incluso cuando el mensaje es solo de diagnóstico.

Notas de seguridad

El parámetro full_path puede reproducir archivos WAV arbitrarios en la máquina local.

Para uso personal local, esto suele ser aceptable.

Si el servidor está expuesto a clientes no confiables, considere:

• eliminar la compatibilidad con full_path;

• o permitir solo directorios específicos;

• o usar solo system_file.

Limitaciones

• Solo Windows.

• Solo se admiten archivos .wav.

• system_file acepta solo un nombre de archivo, no una ruta de carpeta.

• full_path debe ser una ruta absoluta a un archivo existente.

Mensaje del sistema recomendado

Para que el modelo local use la herramienta automáticamente, agregue las siguientes instrucciones al mensaje del sistema de 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")

(También puede encontrar este mensaje en examples/prompts.md).

Licencia

MIT. Consulte LICENSE.