A Model Context Protocol (MCP) 서버는 macOS 알림, 소리 및 텍스트 - 투 - 사운드를 트리거 할 수 있습니다.

✨ 특징

• 계열 ** 소리 알림**: 놀이 시스템은 Submarine, Ping 또는 Tink와 같은 소리
• ✅Banner 알림: customizable title, 메시지 및 자막을 가진 시각적인 통보
• ܧ️Speech 알림: 텍스트를 가변 음성, 속도 및 볼륨으로 변환
• ️️Voice Management: 사용 가능한 시스템 음성에서 목록 및 선택
• 테스트 도구: 모든 알림 방법을 확인하는 진단 유틸리티

AVI 빠른 시작으로 uvx (추천)

이 도구를 사용하는 가장 빠른 방법은 영구 설치없이 패키지를 실행하는 uvx]입니다.

ܧ️ Claude 데스크탑 구성

Claude 데스크탑 구성에 이것을 추가하십시오 (~/Library/Application Support/Claude/claude_desktop_config.json):

Claude 데스크탑을 다시 시작합니다.

☸ 대체 설치 방법

표준 임명:

소스에서 설치:

️ 사용 가능한 알림 도구

는 소리 알림

사용 가능한 소리: Basso, 타격, 병, 개구리, 펑크, 유리, 영웅, 모스, 핑, 팝, Purr, Sosumi, Submarine, Tink

## 배너 알림

🔔 macOS Notification MCP

A Model Context Protocol (MCP) server that enables AI assistants to trigger macOS notifications, sounds, and text-to-speech.

✨ Features

• 🔊 Sound Notifications: Play system sounds like Submarine, Ping, or Tink
• 💬 Banner Notifications: Display visual notifications with customizable title, message, and subtitle
• 🗣️ Speech Notifications: Convert text to speech with adjustable voice, rate, and volume
• 🎙️ Voice Management: List and select from available system voices
• 🧪 Testing Tools: Diagnostic utilities to verify all notification methods

🚀 Quick Start with uvx (Recommended)

The fastest way to use this tool is with uvx, which runs packages without permanent installation:

# 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

⚙️ Configure Claude Desktop

Add this to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json):

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

Then restart Claude Desktop.

📦 Alternative Installation Methods

Standard installation:

pip install macos-notification-mcp

Install from source:

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

🛠️ Available Notification Tools

🔊 Sound Notification

sound_notification(sound_name="Submarine")

Available sounds: Basso, Blow, Bottle, Frog, Funk, Glass, Hero, Morse, Ping, Pop, Purr, Sosumi, Submarine, Tink

💬 Banner Notification

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
)

🗣️ Speech Notification

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
)

🎙️ Voice Management

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

🧪 Testing

test_notification_system()  # Tests all notification methods

🔒 Implementation Details

• ⏱️ Rate Limiting: Notifications are processed one at a time with a minimum interval of 0.5 seconds
• 🔄 Queuing: Multiple notification requests are handled sequentially
• 🪟 OS Integration: Uses native macOS commands (afplay, osascript, say)
• 🔌 FastMCP: Built on the FastMCP framework for AI communication

⚠️ Troubleshooting

• 🔐 Permissions: Ensure notifications are allowed in System Settings → Notifications