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

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

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

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

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

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

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

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

Related MCP server: MCP Sound Tool

⏬ Установка

Установить с помощью менеджера пакетов 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:

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

🧾 Лицензия

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

💻 Вклады

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