macOS Notification MCP

🔔 macOS 알림 MCP

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

✨ 특징

• 🔊 사운드 알림 : 잠수함, 핑, 팅크 등의 시스템 사운드를 재생합니다.
• 💬 배너 알림 : 사용자 정의 가능한 제목, 메시지 및 부제를 사용하여 시각적 알림을 표시합니다.
• 🗣️ 음성 알림 : 음성, 속도, 볼륨을 조절하여 텍스트를 음성으로 변환합니다.
• 🎙️ 음성 관리 : 사용 가능한 시스템 음성을 나열하고 선택합니다.
• 🧪 테스트 도구 : 모든 알림 방법을 검증하는 진단 유틸리티

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

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

지엑스피1

⚙️ Claude Desktop 구성

Claude Desktop 구성에 다음을 추가합니다( ~/Library/Application Support/Claude/claude_desktop_config.json ):

그런 다음 Claude Desktop을 다시 시작하세요.

📦 대체 설치 방법

표준 설치:

소스에서 설치:

🛠️ 사용 가능한 알림 도구

🔊 소리 알림

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

💬 배너 알림

🗣️ 음성 알림

🎙️ 음성 관리

🧪 테스트

🔒 구현 세부 정보

• ⏱️ 속도 제한 : 알림은 최소 0.5초 간격으로 한 번에 하나씩 처리됩니다.
• 🔄 큐잉 : 여러 개의 알림 요청이 순차적으로 처리됩니다.
• 🪟 OS 통합 : 기본 macOS 명령( afplay , osascript , say ) 사용
• 🔌 FastMCP : AI 통신을 위한 FastMCP 프레임워크 기반

⚠️ 문제 해결

• 🔐 권한 : 시스템 설정 → 알림에서 알림이 허용되었는지 확인하세요.
• ⏳ 타이밍 : 한 번에 하나의 알림만 처리됩니다.
• 🌐 환경 : 명령을 직접 사용하는 경우(uvx가 아닌 경우) 전체 경로를 사용해야 할 수 있습니다.

📄 라이센스

MIT 라이센스