mcp_server_notify 是一个 MCP 服务器,当智能体(Agent)任务完成时,它会发送带有音效的桌面通知。
用途:在智能体执行任务结束后,通过桌面系统通知和提示音提醒用户任务已完成,方便用户及时获知结果,无需一直盯着屏幕等待。
主要能力:
- 智能体任务完成后发送系统桌面通知。
- 播放提示音以吸引用户注意,并包含声音文件。
- 跨平台支持(Windows、macOS、Linux)。
- 基于标准 MCP 协议,可与多种 LLM 客户端集成。
使用方式:
- 使用 uv 包管理器进行安装。
- 安装后,可直接调用模块以检查安装是否成功。
- 该模块接受 --debug 或 --file 选项。
与 Claude Desktop 一起使用:
- 找到配置文件 claude_desktop_config.json。
- 如果是全局安装,也可以使用 python 命令。
与 Cursor 一起使用:
- 找到配置文件 ~/.cursor/mcp.json 或 your_project/.cursor/mcp.json。
- 配置后,只需在给 AI 的任务输入末尾添加类似“finally, send me a notification when task finished.”的提示来触发通知。
- 在 Cursor 中,可将此提示作为规则添加到 Cursor Settings -> Rules,以免每次手动输入。
与 VSCode + Copilot 一起使用:
- 安装服务管理器 uv/uvx:pip install uv。
- 将服务添加到 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" : {} } } }。
- 确保使用最新版本的 VSCode,它会自动运行 MCP 服务。
- 打开 VSCode → 启用 Copilot → 切换到 agent 模式。
- 输入 # → 将看到 #send_notification 选项。
- 让智能体运行 #send_notification(它会自动处理通知)。
- 此时 agent 模式下的 Copilot 即可发送桌面通知。
特殊要求:
- 桌面通知的发送使用 Apprise API,因此需要在桌面端安装一些特殊依赖。
Docker 支持:
- 当前不可用,原因是环境兼容性问题。无论宿主操作系统是 Windows、macOS 还是 Linux,Docker 容器若需要触发宿主机通知,解决方案会变得复杂得多,通常直接使用原生通知不可行。具体原因包括:各操作系统(Windows、macOS、Linux)有各自独特的通知机制;Docker 容器的隔离性限制其直接访问宿主操作系统资源的能力;需要处理各操作系统不同的通知库和依赖。
适用场景:
- 适用于使用 Claude Desktop、Cursor、VSCode + Copilot 等支持 MCP 协议的 LLM 客户端的用户,在智能体长时间运行任务后需要及时收到完成提醒的场景。
限制:
- Docker 运行暂不可用。
- 需要额外安装 Apprise API 相关的特殊依赖。
- 关于价格、收费模式等信息暂未提供。