PyPIバージョン

📢 MCP 通知サーバー

エージェントのタスクが完了すると、サウンド効果付きのデスクトップ通知を送信する MCP サーバー。

🥩 機能

エージェントタスクの完了後にシステムデスクトップ通知を送信する
サウンドファイルが内蔵されており、アラートサウンドを再生してユーザーの注意を引きます。
クロスプラットフォームサポート（Windows、macOS、Linux）
標準MCPプロトコルに基づいて、さまざまなLLMクライアントと統合します

⏬ インストール

UVパッケージマネージャーを使用してインストールする

git clone https://github.com/Cactusinhand/mcp_server_notify.git cd mcp_server_notify uv venv source .venv/Scripts/activate uv pip install mcp-server-notify # or pip install mcp-server-notify

インストール後、モジュールを直接呼び出して、インストールが成功したかどうかを確認します。

python -m mcp_server_notify

このモジュールは--debugまたは--fileオプションを受け入れ、次のように使用できます。

python -m mcp_server_notify --debug python -m mcp_server_notify --debug --log-file=path/to/logfile.log

⚠️❕ 特別な要件

** デスクトップ通知の配信にはApprise APIを使用しているため、デスクトップにいくつかの特別な要件をインストールする必要があります**

ウィンドウズ

# windows:// minimum requirements pip install pywin32

macOS

# Make sure terminal-notifier is installed into your system brew install terminal-notifier

📚 使用方法

Claude Desktop での使用:

設定ファイルclaude_desktop_config.jsonを見つけます。

{ "mcpServers": { "NotificationServer": { "command": "uv", "args": [ "--directory", "path/to/your/mcp_server_notify project", "run", "mcp-server-notify", ] } } }

グローバルにインストールされている場合は、python コマンドも使用できます。

{ "mcpServers": { "NotificationServer": { "command": "python", "args": [ "-m", "mcp_server_notify", ] } } }

⚡️ カーソルと一緒に使用する:

設定ファイル~/.cursor/mcp.jsonまたはyour_project/.cursor/mcp.jsonを見つけます。

{ "mcpServers": { "NotificationServer": { "command": "uv", "args": [ "--directory", "path/to/your/mcp_server_notify project", "run", "mcp-server-notify", ] } } }

設定後、 finally, send me a notification when task finished.のようなプロンプトを追加するだけで、通知をトリガーするための AI へのタスク入力が完了します。

カーソルでは、このプロンプトをCursor Settings -> Rulesでルールとして追加できるため、毎回手動で入力する必要はありません。

⚡️ VSCode + Copilot で使用する場合:

サービスマネージャーuv/uvxをインストールします: pip install uv
VSCode 設定にサービスを追加します。
Windows %APPDATA%\Code\User\settings.json
macOS $HOME/Library/Application\ Support/Code/User/settings.json
Linux $HOME/.config/Code/User/settings.json
"mcp": { "servers": { "notifier": { "command": "uvx", "args": [ "mcp-server-notify" ], "env": {} } } }
VSCodeの最新バージョンを使用していることを確認してください。MCPサービスが自動的に実行されます。
VSCode を開く → Copilot を有効にする → エージェントモードに切り替えます。
と入力すると、#send_notification オプションが表示されます。
エージェントに依頼します: #send_notification を実行します (通知は自動的に処理されます)。
エージェントモードの Copilot はデスクトップ通知を送信できるようになりました。