Notifications MCP Server

🚀 Claude Notification macOS通知システム

Claude Notificationは、Claude Desktopでデスクトップ通知を送信するためのmacOSアプリケーションです。このドキュメントでは、macOS上でこの機能を構成し使用する方法を詳しく説明します。

🚀 クイックスタート

Claude Notificationを使うことで、Claude Desktopでのデスクトップ通知を簡単に設定できます。以下のセクションでは、インストール、設定、カスタマイズ、トラブルシューティングなどの手順を説明します。

📦 インストール

1. リポジトリをクローンする

git clone https://github.com/notifications-mcp-server
cd notifications-mCP-server

2. Pythonの依存関係をインストールする

uv pip install -r requirements.txt

3. サンプルスクリプトを実行して機能をテストする

python3 example.py

📚 ドキュメント

基本設定

1. claude_desktop_config.json ファイルを開きます。
2. "notification" オブジェクトに以下のフィールドを追加します。
   • "enabled": true：通知機能を有効にします。
   • "method": "NotificationCenter"：macOSの組み込みNotificationCenterを使用するように選択します。

高度な設定

• カスタムサウンドパス：

  "custom-sound-path": "/System/Library/Sounds/Glass.aiff"
  

• 視覚効果を無効にする：

  "visual-effect": "none"
  

カスタマイズ設定

カスタムサウンド

1. デフォルトのシステムサウンドを使用する：

   afplay /System/Library/Sounds/Glass.aiff
   

2. カスタムサウンドを設定する：

   echo 'export CLA-SOUND="/System/Library/Sounds/Ping.aiff"' >> ~/.zshrc
   source ~/.zshrc
   

表示設定を調整する

1. ターミナルで以下のコマンドを実行します：

   defaults write com.example.notif display-settings -dict modal-height 200
   

2. アプリケーションを再起動して変更を適用します。

トラブルシューティング

視覚効果が表示されない場合

1. 設定ファイルを確認する："visual-effect" の設定が正しいことを確認します。
2. 通知システムをテストする：

   python3 test-visual.py
   

音声が再生されない場合

1. サウンドパスを検証する：オーディオファイルが存在し、.aiff 形式であることを確認します。
2. システム設定を確認する：システムボリュームがミュートになっていないことを確認します。

アンインストールガイド

1. リポジトリを削除する：

   rm -rf /path/to/notifications-mcp-server
   

2. Pythonパッケージを削除する：

   uv pip uninstall notifications-mcp-server fastmcp pyobjc-core pyobjc-framework-Cocoa pync
   

開発ガイド

プロジェクト要件

• Pythonバージョン：3.10+
• 必要なライブラリ：fastmCP, terminal-notifier, pyobjc

テストを実行する

python3 -m pytest tests/

貢献ガイド

1. コードを提出する前に、フォーマットチェックを実行します：

   black .
   

2. 機能ブランチを作成し、変更を提出します。

付録

サポートされるオーディオ形式

• .aiff
• .wav
• .mp3

システム互換性

• macOSバージョン：10.14+

インターフェースドキュメント

詳細なインターフェース情報については、公式ドキュメントを参照してください。

以上の手順に従って、Claude NotificationをmacOS上で正常に設定し使用することができます。何か問題があれば、ユーザーマニュアルを参照するか、サポートチームにお問い合わせください。