MCP Notify Server

MCP Notify Server

Cursor／Windsurf がコード生成を完了したとき、またはユーザーの承認が必要なときに通知音を再生する MCP サーバーです。

機能

• 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 のルールファイルに以下を追加します。

Always Notify by sound using "notify" every time you need user attention
 - when you need user's approval for running the tool
 - when you finish the task
 - DO NOT MAKE MORE THAN ONE SOUND NOTIFICATION.

開発

セットアップ

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 のみをサポートしています
• 通知音は LLM の判断に依存するため、次のようなことが起こる場合があります。
  • 通知のタイミングが予想外になる
  • 通知がときどき行われない
  • 動作にばらつきが生じる可能性がある

コントリビューション

コントリビューションを歓迎します！お気軽にプルリクエストを送信してください。

ライセンス

ISC

作者

@mkusaka

参考資料

• サウンド通知 MCP に関する @ks0318-p の記事
• MCP サーバーのベストプラクティス