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 服務器最佳實踐