Content
# 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
```
You Might Also Like
Ollama
Ollama enables easy access to large language models on various platforms.

n8n
n8n is a secure workflow automation platform for technical teams with 400+...
OpenWebUI
Open WebUI is an extensible web interface for customizable applications.

Dify
Dify is a platform for AI workflows, enabling file uploads and self-hosting.

Zed
Zed is a high-performance multiplayer code editor from the creators of Atom.
MarkItDown MCP
markitdown-mcp is a lightweight MCP server for converting various URIs to Markdown.