MCP ExplorerExplorer

Sound Mcp

@bcharlesonon 10 months ago
2 MIT
FreeCommunity
AI Systems
Every time Cursor agent (or Claude) is done with it's tasks, it'll play a sound to notify you when done!

Overview

What is Sound Mcp

sound-mcp is a Model Context Protocol (MCP) implementation that provides audio feedback by playing sound effects when the Cursor AI completes its tasks, enhancing the interactive coding experience.

Use cases

Use cases include notifying developers upon completion of code generation, providing auditory cues in collaborative coding sessions, and enhancing the overall user experience in coding applications.

How to use

To use sound-mcp, install the necessary dependencies, add your desired sound effects to the ‘sounds’ directory, build the project, and run the MCP server. Customize sound effects and volume as needed.

Key features

Key features include playing sound effects upon task completion, standardized integration via MCP, configurable sound effects, improved error handling, and a stable JSON response format.

Where to use

sound-mcp can be used in software development environments where Cursor AI is employed, particularly for enhancing user interaction and feedback during coding tasks.

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

Tools

No tools

Comments

Recommend MCP Servers

View All MCP Servers