PyPI 버전

📢 MCP 알림 서버

영어 | 중문

에이전트의 업무가 완료되면 사운드 효과와 함께 데스크톱 알림을 보내는 MCP 서버입니다.

🥩 특징

에이전트 작업 완료 후 시스템 데스크톱 알림 보내기
사용자의 주의를 끌기 위해 사운드 파일을 사용하여 경고음을 재생합니다.
크로스 플랫폼 지원(Windows, macOS, Linux)
표준 MCP 프로토콜을 기반으로 다양한 LLM 클라이언트와 통합됩니다.

Related MCP server: MCP Sound Tool

⏬ 설치

uv 패키지 관리자를 사용하여 설치

지엑스피1

설치 후 모듈을 직접 호출하여 설치가 성공했는지 확인하세요.

python -m mcp_server_notify

이 모듈은 --debug 또는 --file 옵션을 허용하며, 다음과 같이 사용할 수 있습니다.

python -m mcp_server_notify --debug python -m mcp_server_notify --debug --log-file=path/to/logfile.log

⚠️❕ 특별 요구 사항

** 데스크톱 알림 전달을 위해 Apprise API를 사용하므로 데스크톱에 몇 가지 특별 요구 사항을 설치해야 합니다.**

윈도우

# windows:// minimum requirements pip install pywin32

맥OS

# Make sure terminal-notifier is installed into your system brew install terminal-notifier

📚 사용법

Claude Desktop과 함께 사용:

구성 파일 claude_desktop_config.json 찾으세요

{ "mcpServers": { "NotificationServer": { "command": "uv", "args": [ "--directory", "path/to/your/mcp_server_notify project", "run", "mcp-server-notify", ] } } }

글로벌하게 설치한 경우 python 명령을 사용할 수도 있습니다.

{ "mcpServers": { "NotificationServer": { "command": "python", "args": [ "-m", "mcp_server_notify", ] } } }

⚡️ 커서와 함께 사용:

구성 파일 ~/.cursor/mcp.json 또는 your_project/.cursor/mcp.json 찾으세요.

{ "mcpServers": { "NotificationServer": { "command": "uv", "args": [ "--directory", "path/to/your/mcp_server_notify project", "run", "mcp-server-notify", ] } } }

구성 후, finally, send me a notification when task finished. 작업 입력이 끝나면 AI에 알림을 보내줍니다.

커서에서 Cursor Settings -> Rules 에 이 프롬프트를 규칙으로 추가하면 매번 수동으로 입력할 필요가 없습니다.

⚡️ VSCode + Copilot과 함께 사용:

서비스 관리자 uv/uvx 설치: pip install uv
VSCode 설정에 서비스를 추가합니다.
윈도우 %APPDATA%\Code\User\settings.json
macOS $HOME/Library/Application\ Support/Code/User/settings.json
리눅스 $HOME/.config/Code/User/settings.json
"mcp": { "servers": { "notifier": { "command": "uvx", "args": [ "mcp-server-notify" ], "env": {} } } }
최신 VSCode 버전을 사용하고 있는지 확인하세요. 이 버전은 MCP 서비스를 자동으로 실행합니다.
VSCode를 열고 → Copilot을 활성화하고 → 에이전트 모드로 전환합니다.
#을 입력하세요 → #send_notification 옵션이 표시됩니다.
상담원에게 문의하세요: #send_notification을 실행하세요(알림이 자동으로 처리됩니다).
이제 에이전트 모드의 Copilot이 데스크톱 알림을 보낼 수 있습니다.

🐳 Docker로 실행하기

현재 환경 호환성 문제로 인해 사용할 수 없습니다. Docker 컨테이너가 호스트 OS가 Windows, macOS, Linux인지 여부와 관계없이 호스트 알림을 트리거해야 하는 경우, 솔루션이 훨씬 더 복잡해지고 네이티브 알림을 직접 사용하는 것은 일반적으로 불가능합니다.

주요 이슈: