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 客户端
mcpPython 包
安装
安装 MCP SDK:
python -m pip install --upgrade pip
python -m pip install "mcp[cli]"将 sound_mcp_server.py 保存到文件夹,例如:
C:\mcp\sound_mcp_server.pyLM 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参数
参数 | 类型 | 必填 | 默认值 | 描述 |
|
| 否 |
| 内置预设。如果提供了 |
|
| 否 |
| 来自 |
|
| 否 |
| WAV 文件的完整路径。 |
|
| 否 |
| 播放重复次数。重复之间的暂停为 3 秒。 |
必须至少指定一个声音源:
sound_type或
system_file或
full_path
如果同时提供了 system_file 和 full_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。
This server cannot be installed
Maintenance
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.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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