mcp-notify

Servidor MCP mínimo que reproduce un sonido de notificación y muestra un banner del sistema en tu ordenador cada vez que tu agente de IA termina una tarea o necesita tu atención.

Funciona con cualquier cliente MCP: Claude Desktop, Claude Code, Cursor, VS Code, opencode, Cline y más. Una configuración de 3 líneas, sin claves API, sin llamadas de red — solo toca tus recursos locales de audio y notificaciones.

Instalación

Añádelo a la configuración MCP de tu cliente (Claude Desktop claude_desktop_config.json, Cursor / VS Code mcp.json, o la configuración de opencode):

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

(usuarios de opencode: misma forma bajo la clave mcp con "type": "local" y "command": ["npx", "-y", "@mrfqcentic/mcp-notify"].)

Requiere Node.js >= 20.

Related MCP server: Notifications MCP Server

Haz que el agente lo llame

Añade una línea a tu AGENTS.md / CLAUDE.md / prompt del sistema:

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.

Herramientas

notify

Reproduce el sonido y muestra un banner. El agente siempre proporciona title (máx. 50 caracteres) y message (máx. 200 caracteres).

list_sounds

Lista los sonidos disponibles y el predeterminado seleccionado actualmente.

Elegir tu sonido

Orden de resolución:

1. Variable de entorno NOTIFY_SOUND — ruta absoluta, explícita y determinista

2. Un archivo en la carpeta sounds/ cuyo nombre empiece por default (tu elección)

3. Primer archivo de audio en la carpeta sounds/ (alfabético — notify-me.mp3 se incluye aquí como predeterminado integrado)

4. El timbre generado en assets/

5. El sonido del sistema (macOS Glass.aiff, Linux bell.oga)

Consejo: renombra o copia tu sonido favorito a sounds/default.mp3 (o establece NOTIFY_SOUND) para que se mantenga.

El sounds/notify-me.mp3 incluido se generó con ElevenLabs bajo una licencia comercial.

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

Consejo: los archivos MP4 con pista de audio también funcionan (macOS afplay lee la transmisión de audio).

Plataformas

Cualquier valor de la variable de entorno CI hace que la reproducción de sonido y banner sean no operativas (se establece automáticamente en los flujos de trabajo de CI) para que el conjunto de pruebas pueda ejecutarse en máquinas sin audio.

Desarrollo

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

Licencia

MIT — ver LICENSE.