mcp-notify

Minimaler MCP-Server, der einen Benachrichtigungston abspielt und ein Systembanner anzeigt, sobald Ihr KI-Agent eine Aufgabe abgeschlossen hat oder Ihre Aufmerksamkeit benötigt.

Funktioniert mit jedem MCP-Client: Claude Desktop, Claude Code, Cursor, VS Code, opencode, Cline und mehr. Eine 3-zeilige Konfiguration, keine API-Schlüssel, keine Netzwerkaufrufe – es greift nur auf Ihre lokalen Audio- und Benachrichtigungsfunktionen zu.

Installation

Fügen Sie es zur MCP-Konfiguration Ihres Clients hinzu (Claude Desktop claude_desktop_config.json, Cursor / VS Code mcp.json oder opencode-Konfiguration):

{
  "mcpServers": {
    "mcp-notify": {
      "command": "npx",
      "args": ["-y", "@mrfqcentic/mcp-notify"]
    }
  }
}

(opencode-Nutzer: gleiche Struktur unter dem mcp-Schlüssel mit "type": "local" und "command": ["npx", "-y", "@mrfqcentic/mcp-notify"].)

Erfordert Node.js >= 20.

Related MCP server: Notifications MCP Server

Lassen Sie den Agenten es aufrufen

Fügen Sie eine Zeile zu Ihrer AGENTS.md / CLAUDE.md / Systemaufforderung hinzu:

When a task is done or the user should be alerted, call the `notify` tool with a short title and a 1–2 sentence description of the result.

Tools

notify

Spielt den Ton ab und zeigt ein Banner. Der Agent liefert immer title (max. 50 Zeichen) und message (max. 200 Zeichen).

list_sounds

Listet verfügbare Sounds und den aktuell ausgewählten Standard auf.

Auswahl Ihres Sounds

Reihenfolge:

1. NOTIFY_SOUND-Umgebungsvariable – absoluter Pfad, explizit und deterministisch

2. Eine Datei im Ordner sounds/, deren Name mit default beginnt

3. Erste Audiodatei im Ordner sounds/ (alphabetisch – notify-me.mp3 wird hier als Standard mitgeliefert)

4. Der generierte Klang in assets/

5. Der Systemklang (macOS Glass.aiff, Linux bell.oga)

Tipp: Benennen Sie Ihren Lieblingssound um oder kopieren Sie ihn nach sounds/default.mp3 (oder setzen Sie NOTIFY_SOUND), damit er dauerhaft verwendet wird.

Der gebündelte sounds/notify-me.mp3 wurde mit ElevenLabs unter einer kommerziellen Lizenz erstellt.

{
  "mcpServers": {
    "mcp-notify": {
      "command": "npx",
      "args": ["-y", "@mrfqcentic/mcp-notify"],
      "env": { "NOTIFY_SOUND": "/absolute/path/to/your-sound.mp3" }
    }
  }
}

Tipp: MP4-Dateien mit einer Tonspur funktionieren ebenfalls (macOS afplay liest den Audiostream).

Plattformen

Jeder CI-Umgebungsvariablenwert macht die Ton- und Bannerwiedergabe zu No-ops (wird automatisch in CI-Workflows gesetzt), sodass die Testsuite auf Maschinen ohne Audio ausgeführt werden kann.

Entwicklung

npm install
npm run typecheck
npm test          # builds, then runs the e2e suite (sound + banner fire locally)

Lizenz

MIT – siehe LICENSE.