Windows System Sounds MCP Server

MCP-сервер для Windows, который воспроизводит встроенные системные звуки Windows или существующие WAV-файлы.

Его можно использовать с LM Studio или любым другим MCP-совместимым клиентом, чтобы уведомить пользователя, когда локальная модель завершает этап, требует внимания, запрашивает разрешение или выполняет всю задачу целиком.

Сервер использует стандартный модуль Windows winsound и не требует загрузки дополнительных аудиофайлов.

Возможности

• Один MCP-инструмент: play_sound.

• Два встроенных пресета:

  • attention — этап завершён, требуется внимание пользователя или запрошено разрешение.

  • done — вся работа завершена.

• Воспроизводит WAV-файлы из папки Windows Media:

  • %SystemRoot%\Media

• Воспроизводит WAV-файлы по полному пути:

  • C:/my-sounds/my_sound.wav

• Повторяет звук несколько раз.

• Пауза между повторами: 3 секунды.

• • Минимальный вывод диагностики в stderr по умолчанию.

• Необязательное отладочное логирование через SOUND_MCP_DEBUG.

Требования

• Windows

• Python 3.10 или новее

• LM Studio или другой MCP-клиент

• Python-пакет mcp

Установка

Установите 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"
      }
    }
  }
}

Некоторые MCP-клиенты, включая LM Studio, могут отображать вывод stderr MCP-сервера как [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.