Skip to main content
Glama
yarikbuilds

Cursor Sound MCP

by yarikbuilds
README.md
# 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.

## Features

- Plays a sound effect when Cursor completes code generation
- Uses the Model Context Protocol (MCP) for standardized integration
- Configurable sound effects

## 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
```

TDQS

D1.7/5.0

Scored across 1 tool

Disambiguation5/5

With only one tool, there is no possibility of ambiguity or confusion between tools. The single tool 'playCompletionSound' has a clear, distinct purpose that cannot be mistaken for any other tool.

Naming Consistency5/5

With only one tool, naming consistency is inherently perfect. The tool name 'playCompletionSound' follows a clear verb_noun pattern, and there are no other tools to create inconsistency.

Tool Count2/5

A single tool is generally too few for most server purposes, as it provides minimal functionality and limits agent capabilities. For a sound-related server, one tool feels thin and under-scoped, lacking operations like stop, pause, or volume control.

Completeness1/5

The tool surface is severely incomplete for a sound server. With only a 'playCompletionSound' tool, there are obvious gaps such as stopping sounds, adjusting volume, listing available sounds, or playing different types of sounds, making it inadequate for typical sound management tasks.

Maintenance

ActivityInactive
ResponsivenessNo issues