macOS 알림 MCP

🔔 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

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

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

apple-notifier-mcp
turlockmike
A
security
A
license
A
quality
A simple MCP server that can send notifications on mac devices.
Last updated -
5
9
8
TypeScript
MIT License
ntfy-mcp
teddyzxcv
-
security
A
license
-
quality
The MCP server that keeps you informed by sending the notification on phone using ntfy.sh
Last updated -
10
6
JavaScript
Apache 2.0
Sound Notification MCP
ks0318-p
-
security
F
license
-
quality
An MCP server that plays notification sounds when AI coding assistants like Windsurf or Cursor require user attention, such as when coding is complete or when user approval is needed.
Last updated -
124
1
TypeScript
Toast MCP Server
naru-sensei
-
security
-
license
-
quality
An MCP server that displays desktop notifications on Windows 10 and macOS, compatible with VSCode Cline and supporting customizable notification parameters.
Last updated -
2
Python
MIT License

View all related MCP servers

macOS Notification MCP