MCP Notify Server

English | 中文

一个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

# 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一起使用：

找到配置文件 ~/.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",
            ]
        }
    }
}

配置后，只需在向AI输入的任务末尾添加类似于finally, send me a notification when task finished.这样的提示即可触发通知。

在Cursor中，您可以将此提示作为规则添加到Cursor设置 -> 规则中，这样每次就不必手动输入了。

通过Docker运行

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

主要问题：

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

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

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

许可证

MIT

贡献

欢迎提出问题和拉取请求！