📢 MCP 알림 서버
영어 | 중문
에이전트의 업무가 완료되면 사운드 효과와 함께 데스크톱 알림을 보내는 MCP 서버입니다.
🥩 특징
- 에이전트 작업 완료 후 시스템 데스크톱 알림 보내기
- 사용자의 주의를 끌기 위해 사운드 파일을 사용하여 경고음을 재생합니다.
- 크로스 플랫폼 지원(Windows, macOS, Linux)
- 표준 MCP 프로토콜을 기반으로 다양한 LLM 클라이언트와 통합됩니다.
⏬ 설치
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인지 여부와 관계없이 호스트 알림을 트리거해야 하는 경우, 솔루션이 훨씬 더 복잡해지고 네이티브 알림을 직접 사용하는 것은 일반적으로 불가능합니다.
주요 이슈:
- OS별 알림 시스템 각 운영 체제(Windows, macOS, Linux)에는 고유한 알림 메커니즘이 있습니다.
- Docker 격리 Docker 컨테이너의 격리는 호스트 운영 체제 리소스에 직접 액세스하는 기능을 제한합니다.
- 종속성 관리 각 운영체제에 대한 다양한 알림 라이브러리와 종속성을 처리해야 합니다.
🧾 라이센스
MIT
💻 기여
이슈와 풀 리퀘스트를 환영합니다!