sound-mcp

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

1. Install dependencies:

npm install

2. 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.

3. 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:

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

Development

For development with auto-recompilation:

npm run dev