MCP Server Notify

🚀 MCP 通知服務器

MCP 通知服務器是一個強大的工具，它能在代理任務完成時，通過系統桌面通知和提示音及時提醒用戶。該服務器支持跨平臺使用，且基於標準 MCP 協議，可與各種 LLM 客戶端集成。

✨ 主要特性

• 系統桌面通知：在代理任務完成後，自動發送系統桌面通知，讓用戶第一時間知曉任務狀態。
• 提示音功能：播放提示音以吸引用戶注意，內置聲音文件，無需額外配置。
• 跨平臺支持：支持 Windows、macOS、Linux 等多種操作系統，滿足不同用戶的使用需求。
• 兼容性強：基於標準 MCP 協議，可與各種 LLM 客戶端無縫集成。

📦 安裝指南

使用 uv 包管理器安裝

git clone https://github.com/Cactusinhand/mcp_server_notify.git
cd mcp_server_notify

uv venv
source .venv/Scripts/activate

uv pip install mcp-server-notify
# 或者
pip install mcp-server-notify

安裝完成後，可直接調用模塊檢查是否安裝成功：

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

# Windows 系統的最低要求
pip install pywin32

• macOS

# 確保終端 notifier 已經安裝到系統中
brew install terminal-notifier

💻 使用示例

與Claude Desktop一起使用

找到配置文件 claude_desktop_config.json

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

如果全局安裝，也可以使用 python 命令：

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

與Cursor一起使用

找到配置文件 ~/.cursor/mcp.json 或 your_project/.cursor/mcp.json

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

配置完成後，只需在任務輸入的末尾添加類似 最後，請在任務完成時通知我。 的提示詞即可觸發通知。在Cursor中，您可以在 Cursor 設置 -> 規則 中將此提示詞作為規則添加，從而避免每次手動輸入。

使用Docker運行

由於環境兼容性問題，當前不可用。如果 Docker 容器需要在主機操作系統為 Windows、macOS 或 Linux 時觸發主機通知，解決方案變得複雜得多，通常直接使用本機通知不可行。主要問題如下：

1. 操作系統特定的通知機制：每個操作系統（Windows、macOS、Linux）都有其獨特的通知機制。
2. Docker 隔離：Docker 容器的隔離限制了它們直接訪問主機操作系統資源的能力。
3. 依賴管理：需要處理每個操作系統的不同通知庫和依賴項。

📄 許可證

本項目採用 MIT 許可證。

貢獻

歡迎提交問題和拉取請求！