Sound Notification MCP （JPN followed By ENG）

基本能力

产品定位

Sound Notification MCP 是一个为AI编程助手设计的通知服务，通过播放系统声音提醒用户注意特定事件。

核心功能

1. 在AI编程助手（如Windsurf或Cursor）需要用户注意时播放通知音。
2. 支持自定义通知音（仅限于macOS系统声音）。
3. 可与Cursor和Windsurf集成。

适用场景

1. 编码完成时的通知。
2. 需要用户批准操作时的提醒。
3. 其他需要用户注意的AI助手事件。

工具列表

1. Node.js (v18以上) - 运行环境
2. Yarn - 包管理器
3. macOS系统声音 - 通知音源

常见问题解答

1. 音が鸣らない场合
2. 系统音量是否正确设置
3. 指定的声音文件是否存在
4. 检查终端输出中的错误信息
5. MCPサーバーが起動しない场合
6. 检查Node.js和Yarn是否正确安装
7. 检查依赖是否安装正确
8. 检查是否有构建错误

使用教程

使用依赖

• Node.js (v18以上)
• Yarn

安装教程

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

# 安装依赖
yarn install

# 构建
yarn build

调试方式

1. 检查终端输出中的错误信息
2. 验证系统音量设置
3. 确认声音文件路径是否正确

# 重新安装依赖
yarn install

# 重新构建
yarn build

许可证

该项目遵循 MIT 开源许可条款。