📢 Сервер уведомлений MCP

английский |中文

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

🥩 Особенности

• Отправлять системные уведомления на рабочий стол после завершения задач агента

• Воспроизводите звуковые оповещения для привлечения внимания пользователя, используя звуковой файл ��нутри.

• Кроссплатформенная поддержка (Windows, macOS, Linux)

• Основан на стандартном протоколе MCP, интегрируется с различными клиентами LLM

⏬ Установка

Установить с помощью менеджера пакетов UV

После установки вызовите модуль напрямую, чтобы проверить успешность установки:

Этот модуль принимает параметр --debug или --file , мы можем использовать его следующим образом:

⚠️❕ Особые требования

** Мы используем API Apprise для доставки уведомлений на наш рабочий стол, поэтому нам необходимо установить некоторые специальные требования на наш рабочий стол **

Окна

macOS

📚 Использование

Использование с Claude Desktop:

Найдите файл конфигурации claude_desktop_config.json

Если установка глобально, вы также можете использовать команду python:

⚡️ Использование с курсором:

Найдите файл конфигурации ~/.cursor/mcp.json или your_project/.cursor/mcp.json

После настройки просто добавьте запрос, например finally, send me a notification when task finished. В конце выполнения задачи введите данные в ИИ, чтобы активировать уведомления.

В Курсоре вы можете добавить эту подсказку как правило в Cursor Settings -> Rules , чтобы вам не приходилось вводить ее вручную каждый раз.

⚡️ Использование с VSCode + Copilot:

1. Установите менеджер служб uv/uvx : pip install uv

2. Добавьте службу в настройки VSCode:

   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. Убедитесь, что вы используете последнюю версию VSCode — она автоматически запускает службы MCP.

4. Откройте VSCode → включите Copilot → переключитесь в режим агента.

5. Введите # → вы увидите опцию #send_notification.

6. Попросите агента: запустить #send_notification (он обработает уведомление автоматически).

7. Теперь Copilot в режиме агента может отправлять уведомления на рабочий стол.

🐳 Работа с Docker

В настоящее время недоступно из-за проблем совместимости среды. Если контейнеры Docker должны запускать уведомления хоста независимо от того, является ли хостовая ОС Windows, macOS или Linux, решение становится намного более сложным, и прямое использование собственных уведомлений обычно нецелесообразно.

Основные вопросы:

1. Системы уведомлений для различных ОС Каждая операционная система (Windows, macOS, Linux) имеет свой уникальный механизм уведомлений.

2. Изоляция Docker Изоляция контейнеров Docker ограничивает их возможность прямого доступа к ресурсам операционной системы хоста.

3. Управление зависимостями Необходимо обрабатывать различные библиотеки уведомлений и зависимости для каждой операционной системы.

🧾 Лицензия

Массачусетский технологический институт

💻 Вклады

Проблемы и запросы на внесение изменений приветствуются!