mcp-notify

Минимальный MCP-сервер, который воспроизводит звук уведомления и показывает системный баннер на вашем компьютере, когда ваш ИИ-агент завершает задачу или требует вашего внимания.

Работает с любым MCP-клиентом: Claude Desktop, Claude Code, Cursor, VS Code, opencode, Cline и другими. Конфиг из 3 строк, никаких API-ключей и сетевых запросов — используются только локальные звуковые и уведомительные возможности.

Установка

Добавьте в конфиг MCP вашего клиента (Claude Desktop claude_desktop_config.json, Cursor / VS Code mcp.json или конфиг opencode):

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

(пользователи opencode: та же структура в ключе mcp с "type": "local" и "command": ["npx", "-y", "@mrfqcentic/mcp-notify"].)

Требуется Node.js >= 20.

Related MCP server: Notifications MCP Server

Как заставить агента вызывать это

Добавьте одну строку в ваш AGENTS.md / CLAUDE.md / системный промпт:

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.

Инструменты

notify

Воспроизводит звук и показывает баннер. Агент всегда передаёт title (макс. 50 символов) и message (макс. 200 символов).

list_sounds

Выводит список доступных звуков и текущий выбранный по умолчанию.

Выбор звука

Порядок выбора:

1. Переменная окружения NOTIFY_SOUND — абсолютный путь, явный и детерминированный

2. Файл в папке sounds/, имя которого начинается с default (ваш выбор)

3. Первый аудиофайл в папке sounds/ (в алфавитном порядке — notify-me.mp3 поставляется как встроенный вариант по умолчанию)

4. Сгенерированный сигнал в assets/

5. Системный звук (macOS Glass.aiff, Linux bell.oga)

Совет: переименуйте или скопируйте ваш любимый звук в sounds/default.mp3 (или задайте NOTIFY_SOUND), чтобы закрепить его.

Встроенный sounds/notify-me.mp3 сгенерирован с помощью ElevenLabs по коммерческой лицензии.

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

Совет: MP4-файлы с аудиодорожкой тоже подойдут (macOS afplay читает аудиопоток).

Платформы

Любое значение переменной окружения CI отключает воспроизведение звука и показ баннера (автоматически задаётся в CI-пайплайнах), чтобы тестовый набор мог запускаться на машинах без аудио.

Разработка

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

Лицензия

MIT — см. LICENSE.