sound-mcp

sound-mcp is an audio processing library built with TypeScript. It provides functionalities for analyzing, converting, and generating audio data, enabling developers to easily create audio-related applications. With a user-friendly API, it supports various audio formats.

GitHub Stars

2

User Rating

Not Rated

Favorites

0

Views

27

Forks

2

Issues

1

README
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
  1. 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.

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