local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Enables system desktop notifications on Linux platforms when AI tasks are completed
Provides native desktop notification support for macOS systems when AI task completion occurs

MCP 通知服务器

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:// 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中将此提示添加为规则，这样您就不必每次都手动输入它。

使用 Docker 运行

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

主要问题：

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

执照

麻省理工学院

贡献

欢迎提出问题和请求！

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

模型上下文协议服务，当 AI 代理任务完成时发送桌面通知和警报声音，并与 Claude Desktop 和 Cursor 等各种 LLM 客户端集成。

Related Resources

Reddit Discussion about this server

Appeared in Searches

Manim - Python Library for Animations and Math Visualization