📢 MCP 通知服务器
英语|中文
当代理任务完成时，MCP 服务器会发送带有声音效果的桌面通知。
🥩 功能
- 代理任务完成后发送系统桌面通知
- 播放警报声音来吸引用户注意力，其中包含声音文件。
- 跨平台支持（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
# 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:// 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/mcp.json或者your_project/.cursor/mcp.json
{
"mcpServers": {
"NotificationServer": {
"command": "uv",
"args": [
"--directory",
"path/to/your/mcp_server_notify project",
"run",
"mcp-server-notify",
]
}
}
}
配置完成后，只需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 → 切换到代理模式。
- 输入# → 您将看到#send_notification 选项。
- 询问代理：运行#send_notification（它将自动处理通知）。
- 现在代理模式下的 Copilot 可以发送桌面通知。
🐳 使用 Docker 运行
由于环境兼容性问题，目前暂不可用。如果 Docker 容器需要触发主机通知，无论主机操作系统是 Windows、macOS 还是 Linux，解决方案都会变得更加复杂，直接使用原生通知通常不可行。
主要问题：
- 特定于操作系统的通知系统 每个操作系统（Windows、macOS、Linux）都有其独特的通知机制。
- Docker 隔离 Docker 容器的隔离限制了它们直接访问主机操作系统资源的能力。
- 依赖管理需要处理每个操作系统不同的通知库和依赖项。
🧾 许可证
麻省理工学院
💻 贡献
欢迎提出问题和请求！