# 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:
```bash
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:
```bash
npm run build
```
## Usage
Run the MCP server:
```bash
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:
```bash
npm run dev
```
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/bcharleson/sound-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server