Sound Notification MCP

声音通知 MCP（日语，后接英语）

该项目是一个 MCP 服务器，当 Windsurf 和 Cursor 等 AI 编码助手需要您的注意时，它会播放通知声音。当编码完成或需要用户批准时，您可以播放通知声音。

注释和免责声明

• *添加设置时，请务必将设置作为一组添加到规则（Windsurf 的内存）中。
• 目前仅支持MacOS。
• 由于 MCP CALL 由 LLM 自行决定，因此可能会在意外的时间听到声音，或者设备可能无法按预期运行。
• 在 Cursor 和 Windsurf 中，执行命令之前通常没有确认提示。
• Windsurf 存在关闭应用程序时通知声音播放多次的问题。 （请注意，积分将被消耗。）

设置

先决条件

• Node.js（v18 或更高版本）
• 纱

安装

现在您可以出发了。

风帆冲浪和光标设置

光标

/.cursor/mcp.json 中提供了一个示例。 （如果在/.cursor/mcp.json中写入，则需要为每个项目分别写入。如果要全局启用，请从设置图标中进行设置。）

风帆冲浪

将设置写入mcp_config.json中。使用与 /.cursor/mcp.json 完全相同的内容就可以了。

定制

更改通知声音

在src/index.ts文件中更改以下内容：

macOS 上可用的系统声音位于/System/Library/Sounds/目录中：

• 瓶子.aiff
• 青蛙艾夫
• Funk.aiff
• 格拉斯·艾夫
• 英雄.aiff
• 莫尔斯·艾夫
• Ping.aiff
• 波普·艾夫
• 呼呼呼
• Sosumi.aiff
• 潜艇.aiff
• 丁克·艾夫

故障排除

如果没有声音

1. 确保您的系统音量设置正确。
2. 请检查指定的音频文件是否存在。
3. 检查终端输出中的错误消息。

如果 MCP 服务器未启动

1. 确保您已正确安装 Node.js 和 Yarn。
2. 确保依赖项已正确安装：
   yarn install
3. 检查构建错误：
   yarn build

执照

麻省理工学院

英文版

该项目是一个 MCP 服务器，当 Windsurf 或 Cursor 等 AI 编码助手需要用户注意时，它会播放通知声音。当编码完成或需要用户批准时，它可以播放通知声音。

注释和免责声明

• * 添加设置时，请务必将相应的条目添加到规则中。
• 目前仅支持 MAC，因为创建者使用 Mac 并且无法在 Windows 上验证。
• 由于 MCP CALLS 依赖于 LLM 判断，声音可能会在意外的时间播放或无法按预期工作。
• 对于光标，在命令执行批准之前有时可能不会播放声音。
• 使用 Windsurf 时，会出现通知声音播放多次的现象。

设置

先决条件

• Node.js（v18 或更高版本）
• 纱

安装

现在您可以出发了。

Windsurf 和 Cursor 的配置

光标

/.cursor/mcp.json中提供了示例配置（写入 /.cursor/mcp.json 需要为每个项目进行配置。如果要全局启用它，请从设置图标进行配置。）

风帆冲浪

将配置添加到mcp_config.json 。内容可以与/.cursor/mcp.json完全相同。

对于风帆冲浪，强烈建议：

1. 将通知说明添加到您的global_rules.md文件中
2. 将通知设置添加到您的记忆中

这确保了AI助手在需要时始终使用声音通知。

定制

更改通知声音

修改src/index.ts文件中的以下部分：

可以在/System/Library/Sounds/目录中找到 macOS 上可用的系统声音：

• 瓶子.aiff
• 青蛙艾夫
• Funk.aiff
• 格拉斯·艾夫
• 英雄.aiff
• 莫尔斯·艾夫
• Ping.aiff
• 波普·艾夫
• 呼呼呼
• Sosumi.aiff
• 潜艇.aiff
• 丁克·艾夫

故障排除

如果没有声音

1. 检查系统音量是否设置正确。
2. 验证指定的声音文件是否存在。
3. 检查终端输出中的错误消息。

如果 MCP 服务器启动失败

1. 验证 Node.js 和 Yarn 是否正确安装。
2. 检查依赖项是否正确安装：
   yarn install
3. 检查构建错误：
   yarn build

执照

麻省理工学院