local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Enables system desktop notifications on Linux platforms when AI tasks are completed
Provides native desktop notification support for macOS systems when AI task completion occurs

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でルールとして追加できるため、毎回手動で入力する必要はありません。

Dockerで実行する

環境互換性の問題により、現在ご利用いただけません。ホストOSがWindows、macOS、Linuxのいずれであっても、Dockerコンテナがホスト通知をトリガーする必要がある場合、ソリューションははるかに複雑になり、ネイティブ通知を直接使用することは通常不可能です。

主な問題点:

OS 固有の通知システム各オペレーティングシステム (Windows、macOS、Linux) には独自の通知メカニズムがあります。
Docker の分離 Docker コンテナの分離により、ホストオペレーティングシステムのリソースに直接アクセスする機能が制限されます。
依存関係の管理オペレーティングシステムごとに異なる通知ライブラリと依存関係を処理する必要があります。

ライセンス

マサチューセッツ工科大学

貢献

問題やプルリクエストを歓迎します!

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

AI エージェントタスクが完了するとデスクトップ通知とアラート音を送信するモデルコンテキストプロトコルサービス。Claude Desktop や Cursor などのさまざまな LLM クライアントと統合されています。

Related Resources

Reddit Discussion about this server

Appeared in Searches

Manim - Python Library for Animations and Math Visualization