MCP 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项目目录",
              "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项目目录",
              "run",
              "mcp-server-notify",
            ]
        }
    }
}

設定が完了したら、タスク入力の末尾に 最後に、タスクが完了したら通知してください。 のようなキーワードを追加するだけで通知をトリガーできます。

Cursor では、Cursor 設定 -> ルール でこのキーワードをルールとして追加することで、毎回手動で入力する手間を省くことができます。

Docker で実行する場合

環境互換性の問題のため、現在は使用できません。 DockerコンテナがWindows、macOS、またはLinuxのホストオペレーティングシステムでホスト通知をトリガーする必要がある場合、解決策ははるかに複雑になり、通常、ネイティブ通知を直接使用することはできません。

主な問題点：

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

📄 ライセンス

MIT

貢献

問題の報告やプルリクエストは大歓迎です！