mcpField
M
MCP Notify Server

MCP Notify Server

Local
github.com/mkusakaDeveloper Tools0Updated 21w ago
Repository

About MCP Notify Server

MCP Notify Server is a macOS MCP server for Cursor and Windsurf users. It plays system notification sounds when code generation finishes or user approval is needed.

Key features

  1. 01macOS system notification sounds
  2. 02Completion notifications
  3. 03Approval-needed notifications
  4. 04Lightweight implementation

Use cases

  1. 01Noticing when code generation finishes
  2. 02Responding to an approval request

MCP support

It exposes notification functionality to MCP clients, allowing Cursor or Windsurf to request a sound when attention is needed.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "notify-server": {
      "command": "npx",
      "args": [
        "-y",
        "@mkusaka/mcp-notify-server"
      ]
    }
  }
}
Run commandnpx -y @mkusaka/mcp-notify-server

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@mkusaka/mcp-notify-server

Tools

1

Saved tool list · updated 3w ago

This tool takes no parameters.

Details

From the project README

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.