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

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

🐳 Работа с Docker

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

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

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

🧾 Лицензия

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

💻 Вклады

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

MCP Notify Server

Integrations