SuperAPI AI 工具集

mcp_server_notify

mcp_server_notify 是一个基于标准 MCP 协议的服务器程序,用于在智能体完成任务后发送带音效的桌面系统通知,以提醒用户任务已结束。它内置提示音文件,可在任务完成时播放声音吸引注意力。该工具跨平台支持 Windows、macOS 和 Linux,能够与多种 LLM 客户端集成。安装使用 uv 包管理器,安装后可直接调用模块验证是否成功,并支持 --debug 或 --file 选项。需要注意的是,桌面通知的发送依赖 Apprise API,因此需要在桌面端安装相应特殊依赖。该工具提供了在 Claude Desktop、Cursor 以及 VSCode + Copilot 中的使用配置方法,配置完成后在任务输入末尾添加类似“finally, send me a notification when task finished.”的提示即可触发通知,在 Cursor 中还可将此提示添加为规则以免每次手动输入。当前暂不支持通过 Docker 运行,因环境兼容性问题。

访问官网

工具介绍

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 相关的特殊依赖。
  • 关于价格、收费模式等信息暂未提供。