声音通知 MCP （日文后跟英文）

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

注意事项&免责声明

• ※添加设置时，请务必在rules（对于windsurf还包括内存）中添加相应的条目。
• 目前仅支持MacOS。
• 由于MCP的调用取决于LLM的判断，因此可能会在意想不到的时间发出声音或不按预期工作。
• 对于Cursor/Windsurf来说，在执行命令前请求批准时通常不会发出声音。
• 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

---

英文版本

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

注意事项&免责声明

• ※ 添加设置时，请始终在规则中添加相应的条目。
• 目前只支持MAC，因为创建者使用的是Mac，并且无法验证Windows上的情况。
• 由于MCP调用依赖于LLM的判断，声音可能在意外时间播放或者不如预期工作。
• 对于Cursor，在命令执行前请求批准时有时不会播放声音。
• 使用Windsurf时，存在一种现象即通知声音可能会多次播放。

设置

前提条件

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

安装

# Clone the repository
git clone <repository-url>
cd sound-notification-mcp

# Install dependencies
yarn install

# Build
yarn build

现在你已经准备好了。

Windsurf 和 Cursor 的配置

Cursor

在/.cursor/mcp.json中提供了一个示例配置。
(将配置写入/.cursor/mcp.json意味着每个项目都需要单独配置。如果你想全局启用，请通过设置图标进行配置。)

Windsurf

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

对于Windsurf，强烈建议：

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

这确保了AI助手在需要时能够一致地使用声音通知。

自定义

更改通知声音

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

const SYSTEM_SOUND_PATH = '/System/Library/Sounds/Glass.aiff'; // macOS default sound

在 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