📢 MCP Notify Server

📢 MCP Notify 服务

English | 中文

一个 MCP 服务，可在 Agent 任务完成时播放音效并发送桌面通知。

🥩 功能

• 在 Agent 任务完成后发送系统桌面通知
• 播放提醒音效以吸引用户注意，内置音效文件。
• 支持跨平台（Windows、macOS、Linux）
• 基于标准 MCP 协议，可与各种大模型客户端集成

⏬ 安装

使用 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
# or
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:// minimum requirements
pip install pywin32

macOS

# 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 配合使用：

找到配置文件 ~/.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",
            ]
        }
    }
}

配置完成后，只需在输入给 AI 的任务末尾添加提示词 finally, send me a notification when task finished.，即可触发通知。

在 Cursor 中，可以将此提示词添加为 Cursor Settings -> Rules 中的规则，这样就不必每次手动输入。

⚡️ 与 VSCode + Copilot 配合使用：

1. 安装服务管理器 uv/uvx： pip install uv

2. 将服务添加到 VSCode 设置中：

   Windows %APPDATA%\Code\User\settings.json
   macOS $HOME/Library/Application\ Support/Code/User/settings.json
   Linux $HOME/.config/Code/User/settings.json

   "mcp": {
       "servers": {
           "notifier": {
               "command": "uvx",
               "args": [
                   "mcp-server-notify"
               ],
               "env": {}
           }
       }
   }
   

3. 确保使用最新版 VSCode——它会自动运行 MCP 服务

4. 打开 VSCode → 启用 Copilot → 切换到 Agent 模式。

5. 输入 # → 即可看到 #send_notification 选项。

6. 让 Agent 运行 #send_notification（它会自动处理通知）。

7. 现在，处于 Agent 模式的 Copilot 可以发送桌面通知了。

🐳 使用 Docker 运行

目前因环境兼容性问题而无法使用。 如果 Docker 容器需要触发宿主机通知，无论宿主机操作系统是 Windows、macOS 还是 Linux，解决方案都会复杂得多，而且通常无法直接使用原生通知。

主要问题：

1. 操作系统专属通知系统 每个操作系统（Windows、macOS、Linux）都有各自独特的通知机制。

2. Docker 隔离 Docker 容器的隔离机制限制了其直接访问宿主操作系统资源的能力。

3. 依赖管理 需要处理各操作系统对应的不同通知库和依赖项。

🧾 许可证

MIT

💻 贡献

欢迎提交问题和拉取请求！