MCP Notify Server: Real-Time Alerts & Enterprise Reliability

Delivers real-time mission-critical alerts with enterprise-grade reliability, seamless cross-platform integration, and scalable notification orchestration for mission-driven teams." )

Visit Repository

✨ Developer Tools

4.4(161 reviews)

241 saves

112 comments

76% of users reported increased productivity after just one week

About MCP Notify Server

What is MCP Notify Server: Real-Time Alerts & Enterprise Reliability?

MCP Notify Server is a specialized server designed to enhance developer productivity by delivering real-time auditory notifications within macOS environments. It integrates seamlessly with tools like Cursor and Windsurf, triggering system sounds to alert users of critical events such as code generation completion or pending approvals. Built with lightweight architecture, it ensures minimal resource consumption while maintaining enterprise-grade reliability through deterministic event handling.

How to Use MCP Notify Server: Real-Time Alerts & Enterprise Reliability?

Deployment follows a straightforward three-step process: install via npm, configure Cursor integration, and define notification rules. Begin by installing the package globally or locally using npm install -g @mkusaka/mcp-notify-server or npx -y @mkusaka/mcp-notify-server. Next, append server configuration to your ~/.cursor/config.json specifying the execution command. Finally, establish rules in your Cursor workflow to trigger notifications at appropriate decision points, ensuring compliance with the "single notification per event" constraint.

MCP Notify Server Features

Key Features of MCP Notify Server: Real-Time Alerts & Enterprise Reliability?

Native macOS sound integration for consistent auditory feedback
Event-driven architecture for code generation completion alerts
User approval workflow triggers with zero false positives
Production硬化 through strict dependency constraints (Node.js 18+)
Inspectable development mode for debugging notification workflows

Use Cases of MCP Notify Server: Real-Time Alerts & Enterprise Reliability?

Developers benefit from this server in scenarios requiring precise human-in-the-loop interactions:

Automated code generation pipelines where post-processing validation is mandatory
Security-critical workflows demanding explicit user authorization before executing generated code
Continuous integration systems needing non-intrusive status updates without visual distractions

MCP Notify Server FAQ

FAQ from MCP Notify Server: Real-Time Alerts & Enterprise Reliability?

Why macOS only?: Relies on Apple's AudioServices framework for precise system sound control unavailable on other platforms.
How to verify notification behavior?: Use npm run inspect to simulate event workflows and validate sound triggers interactively.
Can notifications be customized?: Currently uses system default sounds for reliability, but contribution proposals for sound selection are welcomed.
What causes missed notifications?: Dependent on LLM timing precision; implementing deterministic event queuing in v2.0 will address intermittent delays.

Content

MCP Notify Server

A MCP server that plays notification sounds when Cursor/Windsurf completes code generation or requires user approval.

Features

Uses macOS system notification sounds
Notifies when code generation is complete
Notifies when user approval is needed
Simple and lightweight

Requirements

macOS
Node.js 18 or later

Installation

npx -y @mkusaka/mcp-notify-server

Or install globally:

npm install -g @mkusaka/mcp-notify-server

Configuration

Add the following to your Cursor configuration file (~/.cursor/config.json):

{
  "mcpServers": {
    "notify": {
      "command": "npx",
      "args": ["-y", "@mkusaka/mcp-notify-server"]
    }
  }
}

Rule Configuration

Add the following to your Cursor rules file:

Always Notify by sound using "notify" every time you need user attention
 - when you need user's approval for running the tool
 - when you finish the task
 - DO NOT MAKE MORE THAN ONE SOUND NOTIFICATION.

Development

Setup

git clone https://github.com/mkusaka/mcp-notify-server.git
cd mcp-notify-server
npm install
npm run build

Inspection

You can test the MCP server interactively using mcp-inspector:

npm run inspect

This allows you to test the server's tools and functionality in an interactive environment.

Available Scripts

npm run build - Build the project
npm run start - Start the server
npm run dev - Start the development mode with watch
npm run inspect - Start the interactive inspection mode

Caveats

Currently supports macOS only
Sound notifications depend on LLM's judgment, which may result in:
- Unexpected timing of notifications
- Occasional missed notifications
- Potential variations in behavior

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

ISC

Author

@mkusaka

References

Related MCP Servers & Clients

MCP Categories

Developer Tools