🚀 MCP 通知服务器

MCP 通知服务器是一个强大的工具，它能在代理任务完成时，通过系统桌面通知和提示音及时提醒用户。该服务器支持跨平台使用，且基于标准 MCP 协议，可与各种 LLM 客户端集成。

✨ 主要特性

• 系统桌面通知：在代理任务完成后，自动发送系统桌面通知，让用户第一时间知晓任务状态。
• 提示音功能：播放提示音以吸引用户注意，内置声音文件，无需额外配置。
• 跨平台支持：支持 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
# 或者
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 系统的最低要求
pip install pywin32

• macOS

# 确保终端 notifier 已经安装到系统中
brew install terminal-notifier

💻 使用示例

与Claude Desktop一起使用

找到配置文件 claude_desktop_config.json

{
    "mcpServers": {
        "NotificationServer": {
            "command": "uv",
            "args": [
              "--directory",
              "path/to/your/mcp_server_notify项目目录",
              "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项目目录",
              "run",
              "mcp-server-notify",
            ]
        }
    }
}

配置完成后，只需在任务输入的末尾添加类似 最后，请在任务完成时通知我。 的提示词即可触发通知。在Cursor中，您可以在 Cursor 设置 -> 规则 中将此提示词作为规则添加，从而避免每次手动输入。

使用Docker运行

由于环境兼容性问题，当前不可用。如果 Docker 容器需要在主机操作系统为 Windows、macOS 或 Linux 时触发主机通知，解决方案变得复杂得多，通常直接使用本机通知不可行。主要问题如下：

1. 操作系统特定的通知机制：每个操作系统（Windows、macOS、Linux）都有其独特的通知机制。
2. Docker 隔离：Docker 容器的隔离限制了它们直接访问主机操作系统资源的能力。
3. 依赖管理：需要处理每个操作系统的不同通知库和依赖项。

📄 许可证

本项目采用 MIT 许可证。

贡献

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