🔔 Уведомление macOS MCP

Сервер протокола контекста модели (MCP), который позволяет помощникам на базе искусственного интеллекта запускать уведомления, звуки и преобразование текста в речь в macOS.

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

• 🔊 Звуковые уведомления : воспроизведение системных звуков, таких как подводная лодка, пинг или тинк

• 💬 Уведомления-баннеры : отображение визуальных уведомлений с настраиваемым заголовком, сообщением и подзаголовком.

• 🗣️ Речевые уведомления : преобразуйте текст в речь с регулируемым голосом, скоростью и громкостью

• 🎙️ Управление голосом : список и выбор доступных системных голосов

• 🧪 Инструменты тестирования : диагностические утилиты для проверки всех методов оповещения

Related MCP server: Notifications MCP Server

🚀 Быстрый старт с uvx (рекомендуется)

Самый быстрый способ использования этого инструмента — с помощью uvx , который запускает пакеты без постоянной установки:

# Install uv if you don't have it
curl -LsSf https://astral.sh/uv/install.sh | sh

# Run the MCP server directly (no installation needed)
uvx macos-notification-mcp

⚙️ Настройка рабочего стола Клода

Добавьте это в конфигурацию Claude Desktop ( ~/Library/Application Support/Claude/claude_desktop_config.json ):

{
  "mcpServers": {
    "macos-notification-mcp": {
      "command": "uvx",
      "args": ["macos-notification-mcp"]
    }
  }
}

Затем перезапустите Claude Desktop.

📦 Альтернативные методы установки

Стандартная установка:

pip install macos-notification-mcp

Установка из источника:

git clone https://github.com/devizor/macos-notification-mcp
cd macos-notification-mcp
pip install .

🛠️ Доступные инструменты уведомлений

🔊 Звуковое оповещение

sound_notification(sound_name="Submarine")

Доступные звуки: Basso, Blow, Bottle, Frog, Funk, Glass, Hero, Morse, Ping, Pop, Purr, Sosumi, Submarine, Tink

💬 Баннер-уведомление

banner_notification(
    title="Task Complete",
    message="Your analysis is ready",
    subtitle=None,  # Optional
    sound=False,    # Optional: Play sound with notification
    sound_name=None # Optional: Specify system sound
)

🗣️ Уведомление о речи

speak_notification(
    text="The process has completed",
    voice=None,     # Optional: System voice to use
    rate=150,       # Optional: Words per minute (default: 150)
    volume=1.0      # Optional: Volume level 0.0-1.0
)

🎙️ Голосовое управление

list_available_voices()  # Lists all available text-to-speech voices

🧪 Тестирование

test_notification_system()  # Tests all notification methods

🔒 Подробности реализации

• ⏱️ Ограничение скорости : уведомления обрабатываются по одному с минимальным интервалом в 0,5 секунды.

• 🔄 Очередь : множественные запросы на уведомления обрабатываются последовательно.

• 🪟 Интеграция с ОС : Использует собственные команды macOS ( afplay , osascript , say )

• 🔌 FastMCP : построен на основе фреймворка FastMCP для коммуникации с ИИ

⚠️ Устранение неполадок

• 🔐 Разрешения : убедитесь, что уведомления разрешены в разделе «Настройки системы» → «Уведомления».

• ⏳ Время : одновременно обрабатывается только одно уведомление.

• 🌐 Окружение : если вы используете команду напрямую (не uvx), вам может потребоваться указать полные пути.

📄 Лицензия

Лицензия Массачусетского технологического института