MCP Server Notify

🚀 MCP Notification Server

An MCP server that alerts users via desktop notifications and sound effects upon completion of proxy tasks.

🚀 Quick Start

An MCP server that notifies users through desktop notifications and sound effects when proxy tasks are completed.

✨ Features

• Send system desktop notifications after proxy tasks are completed.
• Play reminder sounds to attract users' attention, with built - in sound files.
• Support cross - platform use (Windows, macOS, Linux).
• Based on the standard MCP protocol, integrate with various LLM clients.

📦 Installation

Install using the uv package manager

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

After installation, directly call the module to check if the installation was successful:

python -m mcp_server_notify

This module accepts the --debug or --file options. We can use it like this:

python -m mcp_server_notify --debug
python -m mcp_server_notify --debug --log-file=path/to/logfile.log

Special Requirements

We use the Apprise API to send desktop notifications, so some special dependencies need to be installed on the desktop.

Windows

# Minimum requirements for Windows systems
pip install pywin32

macOS

# Ensure that the terminal notifier is installed in the system
brew install terminal-notifier

💻 Usage Examples

Use with Claude Desktop

Find the configuration file claude_desktop_config.json

{
    "mcpServers": {
        "NotificationServer": {
            "command": "uv",
            "args": [
              "--directory",
              "path/to/your/mcp_server_notify project directory",
              "run",
              "mcp-server-notify"
            ]
        }
    }
}

If installed globally, you can also use the python command:

{
    "mcpServers": {
        "NotificationServer": {
            "command": "python",
            "args": [
              "-m",
              "mcp_server_notify"
            ]
        }
    }
}

Use with Cursor

Find the configuration file ~/.cursor/mcp.json or your_project/.cursor/mcp.json

{
    "mcpServers": {
        "NotificationServer": {
            "command": "uv",
            "args": [
              "--directory",
              "path/to/your/mcp_server_notify project directory",
              "run",
              "mcp-server-notify"
            ]
        }
    }
}

After configuration, simply add a prompt like Please notify me when the task is completed. at the end of the task input to trigger the notification.

In Cursor, you can add this prompt as a rule in Cursor Settings -> Rules to avoid manual input each time.

Run with Docker

Currently unavailable due to environment compatibility issues. If a Docker container needs to trigger host notifications when the host operating system is Windows, macOS, or Linux, the solution becomes much more complicated, and it is usually not feasible to use native notifications directly.

Main issues:

1. Operating system - specific notification mechanisms Each operating system (Windows, macOS, Linux) has its unique notification mechanism.
2. Docker isolation The isolation of Docker containers limits their ability to directly access host operating system resources.
3. Dependency management It is necessary to handle different notification libraries and dependencies for each operating system.

📄 License

MIT

🔧 Contribution

Welcome to submit issues and pull requests!