Claude Notification Server

Notifications MCP Server

Claude Desktop またはその他の MCP クライアントから、task_status ツールを通じて macOS のサウンド通知や視覚的な通知を送信できる MCP サーバーです。

現在の状況

このユーティリティは macOS 向けです。それ自体で Claude の完了を自動検出するものではありません。通知が必要なときは、MCP クライアントまたはモデルが task_status ツールを呼び出す必要があります。

現在の機能

• task_status MCP ツールを登録します。
• afplay を使って macOS のシステムサウンドを再生します。
• terminal-notifier、AppleScript、PyObjC、pync のフォールバックを使って視覚的な通知を送信します。
• 開始時と完了時に別々のサウンドを設定できます。
• 環境変数を使って視覚的な通知を無効にできます。
• モジュール化された通知マネージャーとサウンドマネージャーのテストが含まれています。

重要な制限事項

• 実装されているプラットフォームは macOS のみです。
• Linux と Windows はサポートされていません。
• 通知は MCP ツールが呼び出されたときにのみ送信されます。
• パッケージに含まれるコンソールスクリプトは claude-notifications です。
• Python パッケージは notifications です。notifications_mcp_server モジュールのエントリーポイントはありません。
• カスタムサウンドの設定には環境変数を使います。以前の README に記載されていた JSON 設定ブロックは使いません。

インストール

pip install notifications-mcp-server

視覚的な通知用のオプションの依存関係：

pip install "notifications-mcp-server[visual]"
pip install "notifications-mcp-server[pync]"

terminal-notifier のフォールバックサポート用：

brew install terminal-notifier

Claude Desktop の設定

パッケージがインストールしたコンソールスクリプトを使います。

{
  "mcpServers": {
    "notifications": {
      "command": "claude-notifications"
    }
  }
}

設定を変更した後は、Claude Desktop を再起動してください。

設定

環境変数：

export CLAUDE_START_SOUND="/System/Library/Sounds/Glass.aiff"
export CLAUDE_COMPLETE_SOUND="/System/Library/Sounds/Hero.aiff"
export CLAUDE_VISUAL_NOTIFICATIONS="true"
export CLAUDE_NOTIFICATION_ICON="/path/to/icon.png"

カスタムサウンドが設定されていない場合、サーバーは macOS のシステムサウンドを使用します。

MCP ツール

task_status

入力：

{
  "message": "Task completed"
}

start または processing を含むメッセージは開始通知として扱われます。それ以外のメッセージは完了通知として扱われます。

動作確認デモ

macOS でローカル診断スクリプトを実行し、利用可能な通知方法をテストします。

python3 test_notification.py

サウンドと視覚的な通知の送信を試みた後、MCP ツールは簡潔なステータスオブジェクトを返します。

{
  "status": "success",
  "message": "Task completed",
  "sound": "/System/Library/Sounds/Hero.aiff",
  "visual": true
}

視覚的な通知の確認を省略して、より静かなスモークテストを実行するには：

CLAUDE_VISUAL_NOTIFICATIONS=false claude-notifications

開発

git clone https://github.com/charles-adedotun/notifications-mcp-server.git
cd notifications-mcp-server
pip install -e ".[dev]"
pytest

ライセンス

MIT