MCP Notify Server

🚀 MCP通知サーバ

MCPサーバで、Cursor/Windsurfがコード生成を完了したとき、またはユーザーの承認が必要なときに、提示音を鳴らします。

🚀 クイックスタート

MCP通知サーバは、Cursor/Windsurfのコード生成やユーザー承認のタイミングで、macOSのシステム提示音を鳴らして通知します。以下に、サーバのセットアップと使用方法を説明します。

✨ 主な機能

• 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」を使用して音声で通知します。
 - ユーザーにツールの実行を承認してもらう必要があるとき
 - タスクが完了したとき
 - 1つ以上の提示音通知を再生しないでください。

💻 使用例

基本的な使用法

サーバを起動するには、以下のコマンドを実行します。

npm run start

高度な使用法

開発モードでサーバを起動するには、以下のコマンドを実行します。

npm run dev

🔧 技術詳細

セットアップ

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サーバのベストプラクティス