📢 MCP Notify Server

📢 MCP Notify Server

English | 中国語

エージェントのタスクが完了したときに、効果音付きのデスクトップ通知を送信する 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

# 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 で使用する：

設定ファイル ~/.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",
            ]
        }
    }
}

設定後、AI へのタスク入力の最後に finally, send me a notification when task finished. のようなプロンプトを追加するだけで、通知が送信されます。

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

⚡️ VSCode + Copilot で使用する：

1. サービスマネージャー uv/uvx をインストールします： pip install uv

2. 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": {}
           }
       }
   }
   

3. 最新バージョンの VSCode を使用していることを確認します。MCP サービスは自動的に実行されます。

4. VSCode を開き → Copilot を有効にして → エージェントモードに切り替えます。

5. を入力すると、#send_notification オプションが表示されます。

6. エージェントに「#send_notification を実行して」と依頼します（通知は自動的に処理されます）。

7. これで、エージェントモードの Copilot からデスクトップ通知を送信できるようになります。

🐳 Docker で実行する

環境との互換性の問題があるため、現在は利用できません。 ホスト OS が Windows、macOS、Linux のいずれであっても、Docker コンテナーからホストの通知をトリガーするには、より複雑な解決策が必要であり、通常、ネイティブ通知を直接使用することはできません。

主な問題：

1. OS 固有の通知システム 各オペレーティングシステム（Windows、macOS、Linux）には、それぞれ固有の通知メカニズムがあります。

2. Docker の分離 Docker コンテナーの分離により、ホスト OS のリソースに直接アクセスする機能が制限されます。

3. 依存関係の管理 各オペレーティングシステム向けに、異なる通知ライブラリと依存関係を処理する必要があります。

🧾 ライセンス

MIT

💻 コントリビューション

Issue とプルリクエストを歓迎します！