声音通知MCP（JPN后接ENG）
此项目包括：Windsurf屋脊Cursor等的AI编码助手在需要用户注意时发出通知音MCP服务器。在编码结束或需要用户批准时发出通知音。
注意事项&免责
- ※追加设定时请务必设置rules（windsurf中描述的场景，使用以下步骤创建明细表，以便在概念设计中分析体量的体积。
- 当前状态MacOS中所述修改相应参数的值。
- MCP的，之CALL表示LLM的判断，有可能在预想之外的时机发出声音或无法按照预想的那样动作。
- Cursor/Windsurf通用的命令执行前的批准大多不响。
- Windsurf结束时会有多次发出通知音的现象。（要用信用卡消费，请注意。）
安装，安装
前提条件
- Node.js (v18以上)
- 纱线
安装
# リポジトリをクローン
git clone
cd sound-notification-mcp
# 依存関係のインストール
yarn install
# ビルド
yarn build现在准备完毕。
Windsurf屋脊Cursor中的设置
光标
样品/。cursor/mcp.json中描述的相应参数的值。 （/.cursor/mcp.json的话，每个项目都需要记载。Global中选择新的扶手类型，来修改默认的扶手。）
帆板运动
mcp_config.json中所述修改相应参数的值。 /.cursor/mcp.json完全一样的内容没有问题。
自定义
更改通知音
src/index.ts修改文件中的以下部分：
const SYSTEM_SOUND_PATH = '/System/Library/Sounds/Glass.aiff'; // macOSのデフォルトサウンド
macOS的系统声音 /System/Library/Sounds/ 在目录中：
- 瓶子.aiff
- 青蛙
- Funk.aiff
- Glass.aiff
- Hero.aiff
- Morse.aiff
- Ping.aiff
- Pop.aiff
- Purr.aiff
- Sosumi.aiff
- 潜艇.aiff
- Tink.aiff
故障排除
没有声音的情况下
- 请确认是否正确设置了系统音量。
- 请确认指定的声音文件是否存在。
- 请在终端输出处确认错误信息。
MCP如果服务器未启动
- Node.js打开Yarn请确认安装是否正确。
- 请确保已正确安装依赖关系：
yarn install- 请检查是否存在构建错误：
yarn build许可证
麻省理工学院
______________________________________________________________________
英文版
该项目是一个MCP服务器，当Windsurf或Cursor等AI编码助手需要用户注意时，它会播放通知声音。当编码完成或需要用户批准时，它可以播放通知声音。
注意事项和免责声明
- ※添加设置时，请务必在规则中添加相应的条目。
- 目前仅支持MAC，因为创建者使用MAC，无法在Windows上验证。
- 由于MCP CALLS取决于LLM的判断，声音可能会在意外的时间播放或不按预期工作。
- 对于Cursor，在命令执行批准之前，声音有时可能无法播放。
- 使用Windsurf时，会出现通知声音可能会播放多次的现象。
设置
先决条件
- Node.js（v18或更高版本）
- 纱线
安装
# Clone the repository
git clone
cd sound-notification-mcp
# Install dependencies
yarn install
# Build
yarn build现在你准备好了。
Windsurf和光标的配置
光标
示例配置见 /.cursor/mcp.json （写入/.cursor/mcp.json需要为每个项目进行配置。如果要全局启用它，请从设置图标进行配置。）
帆板运动
将配置添加到 mcp_config.json. 内容可以与完全相同 /.cursor/mcp.json.
对于Windsurf，强烈建议：
- 将通知说明添加到您的
global_rules.md文件 - 将通知设置添加到您的记忆中
这确保了AI助手在需要时始终使用声音通知。
定制
更改通知声音
修改以下部分 src/index.ts 文件：
const SYSTEM_SOUND_PATH = '/System/Library/Sounds/Glass.aiff'; // macOS default soundmacOS上可用的系统声音可以在 /System/Library/Sounds/ 目录：
- 瓶子.aiff
- 青蛙
- Funk.aiff
- Glass.aiff
- Hero.aiff
- Morse.aiff
- Ping.aiff
- Pop.aiff
- Purr.aiff
- Sosumi.aiff
- 潜艇.aiff
- Tink.aiff
故障排除
如果没有声音播放
- 检查系统音量是否设置正确。
- 验证指定的声音文件是否存在。
- 检查终端输出是否有错误消息。
如果MCP服务器无法启动
- 验证Node.js和Yarn是否已正确安装。
- 检查依赖项是否已正确安装：
yarn install- 检查生成错误：
yarn build许可证
麻省理工学院