PyPI-версия

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

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

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

Отправлять системные уведомления на рабочий стол после завершения задач агента
Воспроизводите звуковые оповещения для привлечения внимания пользователя, используя звуковой файл внутри.
Кроссплатформенная поддержка (Windows, macOS, Linux)
Основан на стандартном протоколе MCP, интегрируется с различными клиентами LLM

⏬ Установка

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

git clone https://github.com/Cactusinhand/mcp_server_notify.git cd mcp_server_notify uv venv source .venv/Scripts/activate uv pip install mcp-server-notify # or pip install mcp-server-notify

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

python -m mcp_server_notify

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

python -m mcp_server_notify --debug python -m mcp_server_notify --debug --log-file=path/to/logfile.log

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

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

Окна

# windows:// minimum requirements pip install pywin32

macOS

# Make sure terminal-notifier is installed into your system brew install terminal-notifier

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

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

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

{ "mcpServers": { "NotificationServer": { "command": "uv", "args": [ "--directory", "path/to/your/mcp_server_notify project", "run", "mcp-server-notify", ] } } }

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

{ "mcpServers": { "NotificationServer": { "command": "python", "args": [ "-m", "mcp_server_notify", ] } } }

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

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

{ "mcpServers": { "NotificationServer": { "command": "uv", "args": [ "--directory", "path/to/your/mcp_server_notify project", "run", "mcp-server-notify", ] } } }

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

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

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

Установите менеджер служб uv/uvx : pip install uv
Добавьте службу в настройки 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": {} } } }
Убедитесь, что вы используете последнюю версию VSCode — она автоматически запускает службы MCP.
Откройте VSCode → включите Copilot → переключитесь в режим агента.
Введите # → вы увидите опцию #send_notification.
Попросите агента: запустить #send_notification (он обработает уведомление автоматически).
Теперь Copilot в режиме агента может отправлять уведомления на рабочий стол.

🐳 Работа с Docker

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

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

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