PyPI-Version

📢 MCP-Benachrichtigungsserver

Ein MCP-Server, der Desktop-Benachrichtigungen mit Soundeffekt sendet, wenn Agentenaufgaben abgeschlossen sind.

🥩 Funktionen

Senden Sie System-Desktopbenachrichtigungen nach Abschluss der Agentenaufgaben
Spielen Sie Warntöne mit einer darin enthaltenen Sounddatei ab, um die Aufmerksamkeit des Benutzers zu erregen.
Plattformübergreifende Unterstützung (Windows, macOS, Linux)
Basierend auf dem Standard-MCP-Protokoll, integriert sich in verschiedene LLM-Clients

⏬ Installation

Installation mit dem UV -Paketmanager

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

Rufen Sie nach der Installation das Modul direkt auf, um zu prüfen, ob die Installation erfolgreich war:

python -m mcp_server_notify

Dieses Modul akzeptiert die Optionen --debug oder --file . Wir können es wie folgt verwenden:

python -m mcp_server_notify --debug python -m mcp_server_notify --debug --log-file=path/to/logfile.log

⚠️❕ Besondere Anforderungen

** Wir verwenden die Apprise- API für die Zustellung unserer Desktop-Benachrichtigungen, daher müssen wir einige spezielle Anforderungen auf unserem Desktop installieren **

Windows

# windows:// minimum requirements pip install pywin32

macOS

# Make sure terminal-notifier is installed into your system brew install terminal-notifier

📚 Verwendung

Verwendung mit Claude Desktop:

Suchen Sie die Konfigurationsdatei claude_desktop_config.json

{ "mcpServers": { "NotificationServer": { "command": "uv", "args": [ "--directory", "path/to/your/mcp_server_notify project", "run", "mcp-server-notify", ] } } }

Bei globaler Installation können Sie auch den Python-Befehl verwenden:

{ "mcpServers": { "NotificationServer": { "command": "python", "args": [ "-m", "mcp_server_notify", ] } } }

⚡️ Verwendung mit Cursor:

Suchen Sie die Konfigurationsdatei ~/.cursor/mcp.json oder your_project/.cursor/mcp.json

{ "mcpServers": { "NotificationServer": { "command": "uv", "args": [ "--directory", "path/to/your/mcp_server_notify project", "run", "mcp-server-notify", ] } } }

Fügen Sie nach der Konfiguration einfach eine Eingabeaufforderung hinzu finally, send me a notification when task finished. Geben Sie am Ende Ihrer Aufgabeneingabe an die KI ein, um Benachrichtigungen auszulösen.

In Cursor können Sie diese Eingabeaufforderung als Regel unter Cursor Settings -> Rules hinzufügen, sodass Sie sie nicht jedes Mal manuell eingeben müssen.

⚡️ Verwendung mit VSCode + Copilot:

Installieren Sie den Service-Manager uv/uvx : pip install uv
Fügen Sie den Dienst zu den VSCode-Einstellungen hinzu:
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": {} } } }
Stellen Sie sicher, dass Sie die neueste VSCode-Version verwenden – sie führt automatisch MCP-Dienste aus
Öffnen Sie VSCode → aktivieren Sie Copilot → wechseln Sie in den Agentenmodus.
Geben Sie # ein → Sie sehen die Option #send_notification.
Bitten Sie den Agenten: Führen Sie #send_notification aus (die Benachrichtigung wird automatisch verarbeitet).
Jetzt kann der Copilot im Agentenmodus Desktop-Benachrichtigungen senden.

🐳 Ausführen mit Docker

Derzeit aufgrund von Umgebungskompatibilitätsproblemen nicht verfügbar. Wenn Docker-Container Hostbenachrichtigungen unabhängig davon auslösen müssen, ob das Host-Betriebssystem Windows, macOS oder Linux ist, wird die Lösung deutlich komplexer, und die direkte Verwendung nativer Benachrichtigungen ist in der Regel nicht möglich.

Hauptprobleme:

Betriebssystemspezifische Benachrichtigungssysteme Jedes Betriebssystem (Windows, macOS, Linux) verfügt über seinen eigenen Benachrichtigungsmechanismus.
Docker-Isolierung: Die Isolierung von Docker-Containern schränkt ihre Fähigkeit ein, direkt auf Ressourcen des Host-Betriebssystems zuzugreifen.
Abhängigkeitsverwaltung: Für jedes Betriebssystem müssen unterschiedliche Benachrichtigungsbibliotheken und Abhängigkeiten verwaltet werden.