MCP 通知服务器

一个 MCP 服务器，在 Cursor/Windsurf 完成代码生成或需要用户批准时播放提示音。

功能

• 使用 macOS 系统提示音
• 代码生成完成时通知
• 需要用户批准时通知
• 简单轻量

需求

• macOS 系统
• Node.js 18 或更高版本

安装

npx -y @mkusaka/mcp-notify-server

或者全局安装：

npm install -g @mkusaka/mcp-notify-server

配置

在你的 Cursor 配置文件 (~/.cursor/config.json) 中添加以下内容：

{
  "mcpServers": {
    "notify": {
      "command": "npx",
      "args": ["-y", "@mkusaka/mcp-notify-server"]
    }
  }
}

规则配置

在你的 Cursor 规则文件中添加以下内容：

每次需要用户注意时，使用 "notify" 播放声音进行通知
 - 当你需要用户批准运行工具时
 - 当任务完成时
 - 不要播放超过一个提示音通知。

开发

设置

git clone https://github.com/mkusaka/mcp-notify-server.git
cd mcp-notify-server
npm install
npm run build

检查

你可以使用 mcp-inspector 交互式地测试 MCP 服务器：

npm run inspect

这允许你在交互环境中测试服务器的工具和功能。

可用脚本

• npm run build - 构建项目
• npm run start - 启动服务器
• npm run dev - 启动开发模式（带有监控）
• npm run inspect - 启动交互式检查模式

注意事项

• 目前仅支持 macOS 系统
• 提示音通知依赖于大语言模型的判断，可能会导致：
  • 呼叫时机意外提前或延后
  • 偶然漏掉提示
  • 行为上可能存在差异

贡献

欢迎贡献！请随意提交 Pull Request。

许可证

ISC

作者

@mkusaka

参考资料

• @ks0318-p 关于声音通知 MCP 的文章
• MCP 服务器最佳实践