🔊 Cursor Sound MCP (for Windows)

Get audio feedback when Cursor AI completes generating code! This simple tool plays a satisfying sound effect whenever Cursor finishes its work, making your coding experience more interactive and enjoyable.

Demo: https://x.com/JonYekarAI/status/1900978269836431527

Installation guide

1. Install Node.js:

   • Download and install from nodejs.org
   • LTS (Long Term Support) version recommended

2. Clone this repository:

   git clone https://github.com/galakurpi/sound-mcp-win.git
   cd sound-mcp
   

   Copy

3. Install project dependencies:

   npm install
   

   Copy

4. Build the project:

   npm run build
   

   Copy

5. Add this command to Cursor MCP settings:

   node [LOCAL DIRECTORY OF CLONED REPO]\dist\index.js
   

   Copy

That's it! Now when Cursor AI completes code generation, you'll hear a sound effect! 🎵

🎵 Customizing Sounds

Want to use your own sound effects? It's easy:

1. Find an MP3 sound you like (try freesound.org)
2. Name it completion.mp3
3. Place it in the sounds folder
4. Restart the server

🛠️ Development

If you're making changes to the code:

npm run dev

This will automatically rebuild the project when you make changes.

📝 Requirements

• Windows 10 or later
• Node.js 16 or later
• PowerShell (comes with Windows)

❓ Troubleshooting

• No sound playing? Make sure:

  • Your system volume is on
  • The sounds/completion.mp3 file exists
  • You have PowerShell available (try running powershell in cmd)

• Error messages? Try:

  • Running npm install again
  • Deleting the dist folder and running npm run build
  • Checking if you have Node.js installed correctly

🤝 Contributing

Found a bug or want to improve something? Talk to me on Twitter!