Skip to main content
Glama
vasjabrevno-dev

Windows System Sounds MCP Server

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

"attention" | "done"

null

内置预设。如果提供了 system_filefull_path,则不需要。

system_file

string

null

来自 %SystemRoot%\Media 的 WAV 文件名。

full_path

string

null

WAV 文件的完整路径。

repeat

integer

1

播放重复次数。重复之间的暂停为 3 秒。

必须至少指定一个声音源:

  • sound_type

  • system_file

  • full_path

如果同时提供了 system_filefull_path,服务器将返回错误。


示例

注意力预设

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

完成预设

{
  "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)可能会将 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

-
license - not tested
-
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

  • Let your AI agent notify you by email, Slack, Discord, or webhook. One tool: send_notification.

  • Send quick greetings, scrape website content, and generate text or images on demand. Perform web s…

  • Schedule tasks for later from your AI agent: reminders, delayed webhooks, recurring jobs.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/vasjabrevno-dev/windows-system-sounds-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server