PyPI 版本

📢 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 可以发送桌面通知。