mcp-notifications

mcp-notifications

🚀 より速くリリースし、見逃しをなくしましょう。

mcp-notifications を使うと、MCP エージェントから、タスクの完了や失敗、重要な更新を知らせるデスクトップ通知を送信できます。

これは特にコンソール AI エージェントに便利です。通常、標準の通知機能が備わっていないためです。

チャットを毎分確認する必要はもうありません。
エージェントからの応答を見逃すこともありません。
デスクトップに表示される、確実なフィードバックだけです。 🔔

このツールが解決するよくある問題

複数の AI エージェントにタスクを任せ、誰が返信したかを何度も確認しながら待つことがあります。

mcp-notifications を使えば、エージェントがユーザーの入力を必要とするときや作業が完了したときに、デスクトップに通知できるため、こうした作業が簡単になります。

チームで導入する理由

• ⚡ MCP ワークフローからすぐにフィードバックが得られます。
• 🧠 集中力を保てます。メインのタスクを続けている間、エージェントに作業を任せられます。
• 🖥️ node-notifier による OS 標準の通知を利用できます。
• 🧵 非ブロッキング動作：通知の送信はバックグラウンドでキューに追加されます。

グローバルにインストールする

要件：

• Node.js >=20
• npm >=10

npm i -g @topvisor/mcp-notifications

実行可能ファイル名（MCP 設定で使用します）：

mcp-notifications

mcp-notifications は MCP サーバーのエントリーポイント（stdio）であり、単発の通知コマンドではありません。

セットアップ：Codex

~/.codex/config.toml に以下を追加します。

[mcp_servers.notifications]
enabled = true
command = "mcp-notifications"
args = []

設定を更新した後、Codex を再起動してください。

セットアップ：Claude Agent

Claude クライアントの設定ファイルに MCP サーバーの設定を追加します。

{
  "mcpServers": {
    "notifications": {
      "command": "mcp-notifications",
      "args": []
    }
  }
}

その後、Claude クライアントを再起動してください。

AI エージェントへの通知指示

通知には、手動と自動の 2 つの方法があります。

ワークフローに合った方法を選んでください。

手動

通知を受け取りたいタスクで、エージェントに明示的に依頼します。例：

Count files in the project; after the task is fully complete, notify me with sound.

特定のチャット内で、サウンド、トピック、頻度に関するルールを定義することもできます。例：

Notify me about your replies without sound, include the reply text, and use title: "Large Refactoring"

自動

自動通知は、グローバルまたはプロジェクトごとに設定できます。

エージェントの返信に対する自動通知を有効にする指示の例：

Send `send_notification` after your replies (actual task time >5 seconds or many steps); `play_sound: false`; `app_id: '{put your chat name here}'`

時間はおおよそのしきい値であり、モデルの動作によって変わるため、好みに合わせてこの指示を調整してください。

スキル内での設定

特定のスキルで通知を有効にすることもできます。レビュー用スキルの例：

After the review, run `send_notification` with a short summary; `play_sound: true`; `app_id: 'Reviewer {put task id here}'`

ツール

send_notification

入力：

• title string（必須）
• message string（必須）
• play_sound boolean（任意、デフォルト：false）
• icon string（任意、画像ファイルへの絶対パスまたは相対パス）
• app_id string（任意、トースト通知の送信元に使用する Windows アプリケーション ユーザー モデル ID）

例：

{
  "title": "Codex",
  "message": "Deployment completed successfully",
  "play_sound": true,
  "icon": "/opt/mcp-notifications/icons/custom.png",
  "app_id": "Topvisor.Codex"
}

app_id（Windows）

• app_id は、Windows のトースト通知に表示される送信元を指定します。
• app_id が設定されていない場合、送信元として SnoreToast が表示されることがあります。
• 各ツール呼び出しで app_id を渡すか、サーバーの環境変数として MCP_NOTIFICATIONS_APP_ID を設定できます。

バックエンドの選択

環境変数 MCP_NOTIFICATIONS_BACKEND で通知の送信方法を選択できます。

• auto（デフォルト）：WSL で利用可能な場合は powershell を使用し、それ以外の場合は node-notifier を使用します。
• powershell：powershell.exe による Windows トースト通知を強制します（WSL での使用を推奨）。
• node-notifier：node-notifier パッケージを強制します。

Codex でテストするチャットプロンプト

以下のメッセージをチャットで直接使用してください。

Check send_notification

Send a notification without sound: title "Test", message "Check"

Send a notification with sound: title "Test", message "Check"

Send a notification with app_id "Topvisor.Codex": title "Test", message "Check"

Send 3 test notifications in a row without sound

ログ／応答で期待されるツールの結果：

Notification queued

動作

• ✅ 標準のシステム通知チャネルを使用します。
• 🔊 play_sound: true の場合、標準のシステム通知音を使用します。
• 🤖 バンドルされている Topvisor のロボット画像を、デフォルトの通知アイコンとして使用します。
• 🧰 通知はバックグラウンドキューで配信されるため、すぐに応答を返します。

例

AI エージェントがあなたを待っています。