声音通知 MCP （JPN followed By ENG）

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

注意事项 & 免责声明

• ※ 添加设置时，请务必同时在 rules（windsurf 需要在内存中）中添加相应的条目。
• 目前仅支持 MacOS，因为创建者使用 Mac 并且无法在 Windows 上进行验证。
• 由于 MCP CALL 依赖于 LLM 的判断，声音可能会在意外的时间播放或无法按预期工作。
• 对于 Cursor，声音有时可能不会在命令执行批准之前播放。
• 对于 Windsurf，存在通知声音可能会多次播放的现象。

设置

前提条件

• Node.js (v18 或更高版本)
• Yarn

安装

# 克隆仓库
git clone <repository-url>
cd sound-notification-mcp

# 安装依赖
yarn install

# 构建
yarn build

现在你已经准备好了。

Windsurf 和 Cursor 的配置

Cursor

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

Windsurf

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

对于 Windsurf，强烈建议：

1. 将通知指令添加到你的 global_rules.md 文件中
2. 将通知设置添加到你的 memories 中

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

自定义

更改通知声音

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

const SYSTEM_SOUND_PATH = '/System/Library/Sounds/Glass.aiff'; // macOS 默认声音

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

• Bottle.aiff
• Frog.aiff
• Funk.aiff
• Glass.aiff
• Hero.aiff
• Morse.aiff
• Ping.aiff
• Pop.aiff
• Purr.aiff
• Sosumi.aiff
• Submarine.aiff
• Tink.aiff

故障排除

如果没有声音播放

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

如果 MCP 服务器启动失败

1. 验证 Node.js 和 Yarn 是否已正确安装。
2. 检查依赖项是否已正确安装：

   yarn install
   

3. 检查是否存在构建错误：

   yarn build
   

许可证

MIT