MCP Notify Server
📢 MCP 通知服务器
当代理任务完成时,MCP 服务器会发送带有声音效果的桌面通知。
🥩 功能
代理任务完成后发送系统桌面通知
播放警报声音来吸引用户注意力,其中包含声音文件。
跨平台支持(Windows、macOS、Linux)
基于标准MCP协议,可与多种LLM客户端集成
Related MCP server: MCP Make Sound
⏬ 安装
使用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 pywin32macOS
# 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 容器的隔离限制了它们直接访问主机操作系统资源的能力。
依赖管理需要处理每个操作系统不同的通知库和依赖项。
🧾 许可证
麻省理工学院
💻 贡献
欢迎提出问题和请求!
Available Tools
1 toolsend_notificationC
Send system notification with optional sound
Inputs: title (required), message (required), play_sound, timeout.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of ambiguity or overlap between tools. The single tool 'send_notification' has a clear, distinct purpose that cannot be confused with any other tool in the set.
The tool name 'send_notification' follows a clear verb_noun pattern (send + notification). Since there is only one tool, consistency is inherently perfect with no deviations or mixed conventions to evaluate.
A single tool is too few for a server named 'MCP Notify Server', which suggests a broader notification domain. This minimal set feels thin and likely incomplete for typical notification workflows, such as managing notifications or checking statuses.
The tool surface is severely incomplete for a notification server. While 'send_notification' covers sending, there are obvious gaps like listing notifications, updating them, deleting them, or configuring notification settings, which agents would need for full functionality.
Maintenance
Related MCP Connectors
Push notifications for AI agents - send instant iPhone notifications from any MCP client.
An MCP connector that lets your AI agents ask you questions, request permission approvals, and send alerts as push notifications to your phone and mac notch, so you can unblock and approve your agents from anywhere.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Let your AI agent notify you by email, Slack, Discord, or webhook. One tool: send_notification.
Related MCP Servers
- AlicenseBqualityDmaintenanceA Model Context Protocol server that allows AI agents to play notification sounds when tasks are completed.141 npm14Apache 2.0
- AlicenseCqualityFmaintenanceA Model Context Protocol server for macOS that enables AI assistants to play system sounds for audio feedback, offering informational, warning, and error sound options.41MIT
- AlicenseAqualityDmaintenanceA persistent state machine and notification system for AI agents to manage complex, multi-step workflows via the Model Context Protocol, preventing context drift by maintaining structured checklists and sending desktop alerts.149 npm2Apache 2.0
- AlicenseBqualityDmaintenanceAn MCP server that lets LLM agents dispatch native OS notifications when a task finishes. It supports cross-platform desktop notifications, task tokens for updates, mobile bridges, and quiet hours.2MIT