agent-notification-mcp-server

Agent Notification MCP Server 🔔

タスク完了時やユーザーアクションが必要な時にデスクトップ通知を送信するMCPサーバーです。

Claude Code設定

npm パッケージ使用 (推奨)

.mcp.json に追加：

{
  "servers": {
    "notification": {
      "command": "npx",
      "args": ["agent-notification-mcp-server"]
    }
  }
}

CLAUDE.md記述例

## タスクが完了したら

agent-notification MCP Tools を使って、通知をしてください。

途中経過の場合は、`WIP:` のように通知の title にラベルを付けてください。
人間に制御を渡す直前に、`DONE: ` のように通知の title にラベルを付けてください。
(本当に最後のタスクが完了した場合のみ、`DONE: ` ラベルを付けた通知を送信してください。その通知が本当に正しいのかがわからずに、人間は迷ってしまうためです。)

インストール

ローカルクローン

git clone https://github.com/tamago324/agent-notification-mcp-server.git
cd agent-notification-mcp-server
bun install
bun run index.ts

利用可能なツール

• notifyAgentCompletion: エージェント処理完了通知
• notifyActionRequired: ユーザーアクション必要通知
• sendCustomNotification: カスタム通知

対応環境

• TODO: Windows 10/11
• TODO: macOS
• TODO: Linux (libnotify必要: sudo apt-get install libnotify-bin)
• WSL2 (Windows通知を自動使用)

トラブルシューティング

通知が表示されない場合:

• Linux: sudo apt-get install libnotify-bin
• macOS: システム環境設定で通知許可を確認
• WSL2: Windows側の通知設定を確認

サーバーが起動しない場合:

bun --version  # Bunバージョン確認
bun install   # 依存関係再インストール

ライセンス

MIT