金大哥 - Sound Notification MCP 详情

article

README

🚀 声音通知 MCP （JPN 优先于 ENG）

本项目搭建了一个MCP服务器，当AI编码助手（如Windsurf或Cursor）需要用户关注时，该服务器会播放提示音。无论是代码编写完成，还是需要用户批准，都能通过声音及时提醒用户。

🚀 快速开始

本项目是一个MCP服务器，用于在AI编码助手如Windsurf或Cursor需要用户注意时播放提示声音。当代码编写完成或需要用户批准时，即可通过该服务器播放提示声音。

⚠️ 注意事项&免责声明

⚠️ 重要提示

添加设置时，请务必同时将相关条目添加到规则中。

当前仅支持 MacOS（由于创建者使用Mac且无法验证Windows环境）。

由于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

确保将以下内容添加到你的全局规则文件global_rules.md和记忆库中：

### 声音通知 MCP 设置
- 在需要提示时使用声音通知。
- 提示声音路径：`/System/Library/Sounds/Glass.aiff`

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

💻 使用示例

基础用法

若需更改提示声音，可修改以下部分的代码：

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

🔧 故障排除

如果没有声音播放

检查系统音量是否已正确设置。
确认指定的声音文件存在。
查看终端输出以获取错误信息。

如果MCP服务器启动失败

确保Node.js和Yarn已正确安装。
检查依赖项是否安装成功：
```
yarn install
```
检查是否有构建错误：
```
yarn build
```

📄 许可证

本项目采用 MIT 许可证。

Sound Notification