📢 MCP-Benachrichtigungsserver

Englisch |中文

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

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

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

⚠️❕ 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

macOS

📚 Verwendung

Verwendung mit Claude Desktop:

Suchen Sie die Konfigurationsdatei claude_desktop_config.json

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

⚡️ Verwendung mit Cursor:

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

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:

1. Installieren Sie den Service-Manager uv/uvx : pip install uv

2. 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": {} } } }

3. Stellen Sie sicher, dass Sie die neueste VSCode-Version verwenden – sie führt automatisch MCP-Dienste aus

4. Öffnen Sie VSCode → aktivieren Sie Copilot → wechseln Sie in den Agentenmodus.

5. Geben Sie # ein → Sie sehen die Option #send_notification.

6. Bitten Sie den Agenten: Führen Sie #send_notification aus (die Benachrichtigung wird automatisch verarbeitet).

7. 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:

1. Betriebssystemspezifische Benachrichtigungssysteme Jedes Betriebssystem (Windows, macOS, Linux) verfügt über seinen eigenen Benachrichtigungsmechanismus.

2. Docker-Isolierung: Die Isolierung von Docker-Containern schränkt ihre Fähigkeit ein, direkt auf Ressourcen des Host-Betriebssystems zuzugreifen.

3. Abhängigkeitsverwaltung: Für jedes Betriebssystem müssen unterschiedliche Benachrichtigungsbibliotheken und Abhängigkeiten verwaltet werden.

🧾 Lizenz

MIT

💻 Beiträge

Probleme und Pull-Anfragen sind willkommen!