Server Notify

🚀 MCP通知サーバ

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
# または
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の最低要件
pip install pywin32

macOS

# ターミナル通知ツールがシステムにインストールされていることを確認
brew install terminal-notifier

💻 使用例

Claude Desktopと一緒に使用する場合

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

{
    "mcpServers": {
        "NotificationServer": {
            "command": "uv",
            "args": [
              "--directory",
              "path/to/your/mcp_server_notify プロジェクト",
              "実行",
              "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 プロジェクト",
              "実行",
              "mcp-server-notify",
            ]
        }
    }
}

設定が完了したら、タスク入力の末尾に 最後に、タスクが完了したら通知してください。 のようなキーワードを追加するだけで通知をトリガーできます。 Cursorでは、Cursor設定 -> ルール でこのキーワードをルールとして追加することで、毎回手動で入力する必要がなくなります。

Dockerで実行する場合

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

主な問題点：

1. オペレーティングシステム固有の通知メカニズム 各オペレーティングシステム（Windows、macOS、Linux）には独自の通知メカニズムがあります。
2. Dockerの隔離性 Dockerコンテナの隔離により、ホストオペレーティングシステムのリソースに直接アクセスすることが制限されます。
3. 依存関係の管理 各オペレーティングシステムの通知ライブラリと依存関係を管理する必要があります。