🔔 macOS 알림 MCP

AI 어시스턴트가 macOS 알림, 사운드, 텍스트 음성 변환을 트리거할 수 있도록 하는 MCP(모델 컨텍스트 프로토콜) 서버입니다.

✨ 특징

• 🔊 사운드 알림 : 잠수함, 핑, 팅크 등의 시스템 사운드를 재생합니다.

• 💬 배너 알림 : 사용자 정의 가능한 제목, 메시지 및 부제를 사용하여 시각적 알림을 표시합니다.

• 🗣️ 음성 알림 : 음성, 속도, 볼륨을 조절하여 텍스트를 음성으로 변환합니다.

• 🎙️ 음성 관리 : 사용 가능한 시스템 음성을 나열하고 선택합니다.

• 🧪 테스트 도구 : 모든 알림 방법을 검증하는 진단 유틸리티

Related MCP server: XcodeBuildMCP

🚀 uvx로 빠르게 시작하기 (권장)

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

지엑스피1

⚙️ Claude Desktop 구성

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")

사용 가능한 사운드: 바소, 블로우, 병, 개구리, 펑크, 유리, 영웅, 모스, 핑, 팝, 푸르르, 소스미, 잠수함, 팅크

💬 배너 알림

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초 간격으로 한 번에 하나씩 처리됩니다.

• 🔄 큐잉 : 여러 개의 알림 요청이 순차적으로 처리됩니다.

• 🪟 OS 통합 : 기본 macOS 명령( afplay , osascript , say ) 사용

• 🔌 FastMCP : AI 통신을 위한 FastMCP 프레임워크 기반

⚠️ 문제 해결

• 🔐 권한 : 시스템 설정 → 알림에서 알림이 허용되었는지 확인하세요.

• ⏳ 타이밍 : 한 번에 하나의 알림만 처리됩니다.

• 🌐 환경 : 명령을 직접 사용하는 경우(uvx가 아닌 경우) 전체 경로를 사용해야 할 수 있습니다.

📄 라이센스

MIT 라이센스