Cursor Sound MCP

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

Inspired by @EricListin on X.com - I have made some changes to the code to not error out and be online.

Features

Plays a sound effect when Cursor completes code generation
Uses the Model Context Protocol (MCP) for standardized integration
Configurable sound effects
Improved error handling and logging
Stable JSON response format

Cursor Rules

Add this to your Cursor custom instructions:

"EVERY TIME you finish any task or you need something from me, run the sound-mcp MCP server to get my attention."

Installation

Install dependencies:

npm install

Add your sound effects: Place your sound files in the sounds directory. The default expected sound is:

sounds/completion.mp3 - Played after code generation

You can find free sound effects on freesound.org.

Build the project:

npm run build

Usage

Run the MCP server:

npm start

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

Configuration

The sound effects and volume can be customized by:

Replacing the sound files in the sounds directory
Modifying the sound file paths in src/index.ts

Development

For development with auto-recompilation:

npm run dev

Integrations