macOS-Benachrichtigungs-MCP

🔔 macOS-Benachrichtigungs-MCP

Ein Model Context Protocol (MCP)-Server, der es KI-Assistenten ermöglicht, macOS-Benachrichtigungen, Töne und Text-to-Speech auszulösen.

✨ Funktionen

🔊 Tonbenachrichtigungen : Spielen Sie Systemgeräusche wie Submarine, Ping oder Tink ab
💬 Bannerbenachrichtigungen : Zeigen Sie visuelle Benachrichtigungen mit anpassbarem Titel, Nachricht und Untertitel an
🗣️ Sprachbenachrichtigungen : Wandeln Sie Text in Sprache um, mit einstellbarer Stimme, Geschwindigkeit und Lautstärke
🎙️ Sprachverwaltung : Liste und Auswahl der verfügbaren Systemstimmen
🧪 Testtools : Diagnoseprogramme zum Überprüfen aller Benachrichtigungsmethoden

🚀 Schnellstart mit uvx (empfohlen)

Am schnellsten lässt sich dieses Tool mit uvx verwenden, das Pakete ohne permanente Installation ausführt:

# Install uv if you don't have it
curl -LsSf https://astral.sh/uv/install.sh | sh

# Run the MCP server directly (no installation needed)
uvx macos-notification-mcp

⚙️ Claude Desktop konfigurieren

Fügen Sie dies zu Ihrer Claude Desktop-Konfiguration hinzu ( ~/Library/Application Support/Claude/claude_desktop_config.json ):

{
  "mcpServers": {
    "macos-notification-mcp": {
      "command": "uvx",
      "args": ["macos-notification-mcp"]
    }
  }
}

Starten Sie dann Claude Desktop neu.

📦 Alternative Installationsmethoden

Standardinstallation:

pip install macos-notification-mcp

Von der Quelle installieren:

git clone https://github.com/devizor/macos-notification-mcp
cd macos-notification-mcp
pip install .

🛠️ Verfügbare Benachrichtigungstools

🔊 Tonbenachrichtigung

sound_notification(sound_name="Submarine")

Verfügbare Sounds: Basso, Blow, Bottle, Frog, Funk, Glass, Hero, Morse, Ping, Pop, Purr, Sosumi, Submarine, Tink

💬 Bannerbenachrichtigung

banner_notification(
    title="Task Complete",
    message="Your analysis is ready",
    subtitle=None,  # Optional
    sound=False,    # Optional: Play sound with notification
    sound_name=None # Optional: Specify system sound
)

🗣️ Sprachbenachrichtigung

speak_notification(
    text="The process has completed",
    voice=None,     # Optional: System voice to use
    rate=150,       # Optional: Words per minute (default: 150)
    volume=1.0      # Optional: Volume level 0.0-1.0
)

🎙️ Sprachverwaltung

list_available_voices()  # Lists all available text-to-speech voices

🧪 Testen

test_notification_system()  # Tests all notification methods

🔒 Implementierungsdetails

⏱️ Ratenbegrenzung : Benachrichtigungen werden einzeln mit einem Mindestintervall von 0,5 Sekunden verarbeitet
🔄 Warteschlange : Mehrere Benachrichtigungsanfragen werden nacheinander bearbeitet
🪟 Betriebssystemintegration : Verwendet native macOS-Befehle (z say``afplay , osascript )
🔌 FastMCP : Basierend auf dem FastMCP-Framework für KI-Kommunikation

⚠️ Fehlerbehebung

🔐 Berechtigungen : Stellen Sie sicher, dass Benachrichtigungen in den Systemeinstellungen → Benachrichtigungen zulässig sind
⏳ Timing : Es wird immer nur eine Benachrichtigung gleichzeitig verarbeitet
🌐 Umgebung : Wenn Sie den Befehl direkt verwenden (nicht uvx), müssen Sie möglicherweise vollständige Pfade verwenden

📄 Lizenz

MIT-Lizenz

macOS Notification MCP