📢 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 はデスクトップ通知を送信できるようになりました。
🐳 Docker で実行する
環境互換性の問題により、現在ご利用いただけません。ホストOSがWindows、macOS、Linuxのいずれであっても、Dockerコンテナがホスト通知をトリガーする必要がある場合、ソリューションははるかに複雑になり、ネイティブ通知を直接使用することは通常不可能です。
主な問題点:
- OS 固有の通知システム 各オペレーティング システム (Windows、macOS、Linux) には独自の通知メカニズムがあります。
- Docker の分離 Docker コンテナの分離により、ホスト オペレーティング システムのリソースに直接アクセスする機能が制限されます。
- 依存関係の管理 オペレーティング システムごとに異なる通知ライブラリと依存関係を処理する必要があります。
🧾 ライセンス
マサチューセッツ工科大学
💻 貢献
問題やプルリクエストを歓迎します!