TA

turlockmike/apple-notifier-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

26 stars 10 forks Качество 73 Тренд 11MIT

Отправляйте нативные уведомления macOS и взаимодействуйте с системными диалогами через любой MCP-совместимый клиент, такой как Claude Desktop или Cline.

Обзор

Отправляйте нативные уведомления macOS и взаимодействуйте с системными диалогами через любой MCP-совместимый клиент, такой как Claude Desktop или Cline. - macOS - Node.js >= 18 - MCP-совместимый клиент (Claude Desktop, Cline) Для отображения уведомлений терминалу или приложению, работающему на сервере MCP, требуются разрешения уведомлений в macOS. 1. - Open (или на macOS Ventura+) - Go to - Find или (в зависимости от того, что появится) - Enable - Set alert style to or 2. - Открыть > - Найти (или, если используется iTerm2) 3. - Запустите тестовое уведомление вручную в Терминале: - Это должно запустить macOS, чтобы запросить или зарегистрировать разрешения на уведомление - Затем снова проверьте Системные предпочтения 4. - Убедитесь, что режим фокусировки или не беспокоить не включен - проверьте Центр управления в панели меню Тест с терминала перед использованием через MCP:

Обзор (машинный перевод)

Отправляйте нативные уведомления macOS и взаимодействуйте с системными диалогами через любой MCP-совместимый клиент, такой как Claude Desktop или Cline.

Предпосылки

macOS Node.js >= 18 MCP-совместимый клиент (Claude Desktop, Cline)

##Устранение неполадок: уведомления не появляются

Для отображения уведомлений терминалу или приложению, работающему на сервере MCP, требуются разрешения уведомлений в macOS.

Разрешение на получение гранта

1 **Для пользователей Claude Desktop: **

  • Открытые Системные настройки (или Системные настройки на macOS Ventura+) Перейти к **Уведомления **
  • Найдите Узел или терминальный уведомитель (в зависимости от того, что появится) ** Разрешить уведомления**
  • Настройте стиль оповещения для ** Баннеры** или Алерты

2 **Для пользователей Claude Code / Terminal: **

  • Открытые Системные преференцииУведомления*
  • Найти ** Терминал** (или iTerm при использовании iTerm2) ** Разрешить уведомления**
  1. ** Если приложение не отображается в настройках уведомлений: ** Запуск тестового уведомления вручную в Терминале:

Это должно заставить macOS запрашивать или регистрировать разрешения на уведомления. Проверьте системные предпочтения еще раз

4 **Проверить режим фокусировки / Не беспокоить: **

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

Apple Notifier MCP Server

Send native macOS notifications and interact with system dialogs through any MCP-compatible client like Claude Desktop or Cline.

Prerequisites

  • macOS
  • Node.js >= 18
  • An MCP-compatible client (Claude Desktop, Cline)

Troubleshooting: Notifications Not Appearing

For notifications to display, the terminal or application running the MCP server needs notification permissions in macOS.

Grant Notification Permissions

  1. For Claude Desktop users:

    • Open System Preferences (or System Settings on macOS Ventura+)
    • Go to Notifications
    • Find Node or terminal-notifier (whichever appears)
    • Enable Allow Notifications
    • Set alert style to Banners or Alerts
  2. For Claude Code / Terminal users:

    • Open System Preferences > Notifications
    • Find Terminal (or iTerm if using iTerm2)
    • Enable Allow Notifications
  3. If the app doesn’t appear in Notifications settings:

    • Run a test notification manually in Terminal:
      osascript -e 'display notification "Test" with title "Hello"'
      
    • This should trigger macOS to prompt for or register notification permissions
    • Then check System Preferences again
  4. Check Focus Mode / Do Not Disturb:

    • Ensure Focus Mode or Do Not Disturb is not enabled
    • Check the Control Center in the menu bar

Verify Notifications Work

Test from terminal before using via MCP:

osascript -e 'display notification "Test message" with title "Test title"'

If this shows a notification, the MCP server should work correctly.

Installation

Installing via Smithery

To install Apple Notifier for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install apple-notifier-mcp --client claude

Manual Installation

  1. Install the package globally:
npm install -g apple-notifier-mcp
  1. Add to your MCP configuration file:

For Cline (cline_mcp_settings.json):

{
  "mcpServers": {
    "apple-notifier": {
      "command": "apple-notifier-mcp"
    }
  }
}

For Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "apple-notifier": {
      "command": "apple-notifier-mcp"
    }
  }
}

Features

Send Notifications

Display native macOS notifications with customizable content.

Parameters:

  • title (required): string - The title of the notification
Открыть полный README на GitHub

Установка

npx -y @smithery/cli install apple-notifier-mcp --client claude
Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "mcpServers": { "apple-notifier": { "command": "apple-notifier-mcp" } } }