Cursor Sound Notifications

🚀 Cursor Sound MCP

A Model Context Protocol (MCP) implementation that plays a sound effect after Cursor AI completes code generation. This MCP integrates with Cursor to provide audio feedback for a more interactive coding experience.

🚀 Quick Start

This project is a Model Context Protocol (MCP) implementation designed to play a sound effect after Cursor AI finishes code generation. It integrates with Cursor, offering audio feedback for a more engaging coding experience. Inspired by @EricListin's sharing on X.com, I've made some code modifications to avoid errors and enable online operation.

✨ Features

• Play a sound effect when Cursor finishes code generation.
• Implement standardized integration using the Model Context Protocol (MCP).
• Configurable sound effects.
• Improved error handling and logging.
• Stable JSON response format.

📋 Cursor Rule

Add the following to your Cursor custom instructions: "Every time you complete any task or need something from me, run the Sound - MCP server to get my attention."

📦 Installation

1. Install dependencies:

npm install

2. Add your sound effect files: Place your sound effect files in the sounds directory. The default expected sound files are:

• sounds/completion.mp3 - Played after code generation is complete. You can find free sound effects on freesound.org.

3. Build the project:

npm run build

💻 Usage Examples

Basic Usage

Run the MCP server:

npm start

The server will start and listen for events from Cursor via stdio transport.

⚙️ Configuration

Sound effects and volume can be customized in the following ways:

1. Replace the sound effect files in the sounds directory.
2. Modify the sound file paths in src/index.ts.

🔨 Development

For feature development with automatic recompilation:

npm run dev