📢 MCP 通知服务器

英语|中文

当代理任务完成时，MCP 服务器会发送带有声音效果的桌面通知。

🥩 功能

• 代理任务完成后发送系统桌面通知

• 播放警报声音来吸引用户注意力，其中包含声音文件。

• 跨平台支持（Windows、macOS、Linux）

• 基于标准MCP协议，可与多种LLM客户端集成

⏬ 安装

使用uv包管理器安装

安装完成后直接调用模块检查是否安装成功：

该模块接受--debug或--file选项，我们可以像这样使用它：

⚠️❕ 特殊要求

** 我们使用Apprise API 来发送桌面通知，因此我们需要在桌面上安装一些特殊要求 **

视窗

macOS

📚 使用方法

与 Claude Desktop 一起使用：

找到配置文件claude_desktop_config.json

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

⚡️ 与光标一起使用：

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

配置完成后，只需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 → 切换到代理模式。

5. 输入# → 您将看到#send_notification 选项。

6. 询问代理：运行#send_notification（它将自动处理通知）。

7. 现在代理模式下的 Copilot 可以发送桌面通知。

🐳 使用 Docker 运行

由于环境兼容性问题，目前暂不可用。如果 Docker 容器需要触发主机通知，无论主机操作系统是 Windows、macOS 还是 Linux，解决方案都会变得更加复杂，直接使用原生通知通常不可行。

主要问题：

1. 特定于操作系统的通知系统 每个操作系统（Windows、macOS、Linux）都有其独特的通知机制。

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

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

🧾 许可证

麻省理工学院

💻 贡献

欢迎提出问题和请求！