local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Enables system desktop notifications on Linux platforms when AI tasks are completed
Provides native desktop notification support for macOS systems when AI task completion occurs

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 에 이 프롬프트를 규칙으로 추가하면 매번 수동으로 입력할 필요가 없습니다.

Docker로 실행

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

주요 이슈: