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 項目",
              "運行",
              "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 項目",
              "運行",
              "mcp-server-notify",
            ]
        }
    }
}

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

使用Docker運行

由於環境兼容性問題，目前不可用。如果Docker容器需要無論宿主機OS是Windows、macOS還是Linux都能觸發宿主通知，解決方案變得複雜得多，通常直接使用原生通知不可行。

主要問題：

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