MCP Notify Server

📢 MCP 알림 서버

영어 | 중문

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

🥩 특징

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

⏬ 설치

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

지엑스피1

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

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

⚠️❕ 특별 요구 사항

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

윈도우

맥OS

📚 사용법

Claude Desktop과 함께 사용:

구성 파일 claude_desktop_config.json 찾으세요

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

⚡️ 커서와 함께 사용:

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

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

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

⚡️ VSCode + Copilot과 함께 사용:

1. 서비스 관리자 uv/uvx 설치: pip install uv
2. 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": {} } } }
3. 최신 VSCode 버전을 사용하고 있는지 확인하세요. 이 버전은 MCP 서비스를 자동으로 실행합니다.
4. VSCode를 열고 → Copilot을 활성화하고 → 에이전트 모드로 전환합니다.
5. #을 입력하세요 → #send_notification 옵션이 표시됩니다.
6. 상담원에게 문의하세요: #send_notification을 실행하세요(알림이 자동으로 처리됩니다).
7. 이제 에이전트 모드의 Copilot이 데스크톱 알림을 보낼 수 있습니다.

🐳 Docker로 실행하기

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

주요 이슈:

1. OS별 알림 시스템 각 운영 체제(Windows, macOS, Linux)에는 고유한 알림 메커니즘이 있습니다.
2. Docker 격리 Docker 컨테이너의 격리는 호스트 운영 체제 리소스에 직접 액세스하는 기능을 제한합니다.
3. 종속성 관리 각 운영체제에 대한 다양한 알림 라이브러리와 종속성을 처리해야 합니다.

🧾 라이센스

MIT

💻 기여

이슈와 풀 리퀘스트를 환영합니다!