
turlockmike/apple-notifier-mcp
Developer toolsЭта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал
Отправляйте нативные уведомления 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) ** Разрешить уведомления**
- ** Если приложение не отображается в настройках уведомлений: ** Запуск тестового уведомления вручную в Терминале:
Это должно заставить 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
-
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
-
For Claude Code / Terminal users:
- Open System Preferences > Notifications
- Find Terminal (or iTerm if using iTerm2)
- Enable Allow Notifications
-
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
- Run a test notification manually in Terminal:
-
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
- Install the package globally:
npm install -g apple-notifier-mcp
- 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
Установка
npx -y @smithery/cli install apple-notifier-mcp --client claudeКонфигурация
{
"mcpServers": {
"apple-notifier": {
"command": "apple-notifier-mcp"
}
}
}