mcpserver.so LogoMCPFly
Submit
MCP Notify Server logo

MCP Notify Server

by mkusaka

Development/ToolsmacOSnotificationCursorWindsurfcode generation

MCP Notify Server plays macOS system notification sounds when Cursor/Windsurf completes code generation or requires user approval. It's a simple and lightweight way to stay informed about your code generation tasks.

View on GitHub

Last updated: N/A

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