MIT License
🔔 macOS 알림 MCP
AI 어시스턴트가 macOS 알림, 사운드, 텍스트 음성 변환을 트리거할 수 있도록 하는 MCP(모델 컨텍스트 프로토콜) 서버입니다.
✨ 특징
🔊 사운드 알림 : 잠수함, 핑, 팅크 등의 시스템 사운드를 재생합니다.
💬 배너 알림 : 사용자 정의 가능한 제목, 메시지 및 부제를 사용하여 시각적 알림을 표시합니다.
🗣️ 음성 알림 : 음성, 속도, 볼륨을 조절하여 텍스트를 음성으로 변환합니다.
🎙️ 음성 관리 : 사용 가능한 시스템 음성을 나열하고 선택합니다.
🧪 테스트 도구 : 모든 알림 방법을 검증하는 진단 유틸리티
🚀 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 라이센스
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
macOS 알림 MCP
Related MCP Servers
- MIT License