Sound Notification MCP （日语后接英语）

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

注意事项及免责声明

• ※ 添加设置时，请务必在规则中添加相应的条目（对于Windsurf来说是在内存中）。
• 目前仅支持MacOS。
• 由于MCP调用依赖于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完全相同。

自定义

更改通知音

修改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