MCP Notify Server

🚀 MCP 通知服务器

MCP 通知服务器是一个专为 macOS 系统打造的实用工具。它能在 Cursor/Windsurf 完成代码生成，或是需要用户批准相关操作时，及时播放提示音，有效提升用户的使用体验和工作效率。

✨ 主要特性

• 系统适配：使用 macOS 系统提示音，与系统完美融合。
• 精准通知：代码生成完成时及时通知，需要用户批准时也能迅速提醒。
• 轻量便捷：简单轻量，不占用过多系统资源。

📦 安装指南

临时安装

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 服务器最佳实践