Related MCP Server Resources

Explore more AI models, providers, and integration options:

  • Explore AI Models
  • Explore AI Providers
  • Explore MCP Servers
  • LangDB Pricing
  • Documentation
  • AI Industry Blog
  • Readwise MCP
  • DaVinci Resolve MCP
  • MindManager MCP Server
  • MCP Apple Calendars
  • Kali Linux MCP Server
Back to MCP Servers
MCP Sound Tool

MCP Sound Tool

Public
tijs/py-sound-mcp

Plays configurable sound effects for completion, error, and notification events in MCP-compatible environments, enhancing interactive coding experiences through standardized Model Context Protocol integration across Windows, macOS, and Linux.

python
0 tools
May 29, 2025
Updated Jun 4, 2025

Supercharge Your AI with MCP Sound Tool

MCP Server

Unlock the full potential of MCP Sound Tool through LangDB's AI Gateway. Get enterprise-grade security, analytics, and seamless integration with zero configuration.

Unified API Access
Complete Tracing
Instant Setup
Get Started Now

Free tier available • No credit card required

Instant Setup
99.9% Uptime
10,000+Monthly Requests

MCP Sound Tool

A Model Context Protocol (MCP) implementation that plays sound effects for Cursor AI and other MCP-compatible environments. This Python implementation provides audio feedback for a more interactive coding experience.

Features

  • Plays sound effects for various events (completion, error, notification)
  • Uses the Model Context Protocol (MCP) for standardized integration with Cursor and other IDEs
  • Cross-platform support (Windows, macOS, Linux)
  • Configurable sound effects

Installation

Python Version Compatibility

This package is tested with Python 3.8-3.11. If you encounter errors with Python 3.12+ (particularly BrokenResourceError or TaskGroup exceptions), please try using an earlier Python version.

Recommended: Install with pipx

The recommended way to install mcp-sound-tool is with pipx, which installs the package in an isolated environment while making the commands available globally:

# Install pipx if you don't have it python -m pip install --user pipx python -m pipx ensurepath # Install mcp-sound-tool pipx install mcp-sound-tool

This method ensures that the tool has its own isolated environment, avoiding conflicts with other packages.

Alternative: Install with pip

You can also install directly with pip:

pip install mcp-sound-tool

From Source

  1. Clone this repository:

    git clone https://github.com/yourusername/mcp-sound-tool cd mcp-sound-tool
  2. Install with pipx directly from the source directory:

    pipx install .

    Or with pip:

    pip install -e .

Usage

Adding Sound Files

Place your sound files in the sounds directory. The following sound files are expected:

  • completion.mp3 - Played after code generation
  • error.mp3 - Played when an error occurs
  • notification.mp3 - Used for general notifications

You can find free sound effects on websites like freesound.org.

Running the MCP Server

Run the MCP server:

mcp-sound-tool

The server will start and listen for events from Cursor or other MCP-compatible clients through the stdio transport.

Configuration in Cursor

To use this server with Cursor, add it to your MCP configuration file:

On macOS:

// ~/Library/Application Support/Cursor/mcp.json { "mcpServers": { "sound": { "command": "mcp-sound-tool", "args": [], "type": "stdio", "pollingInterval": 5000, "startupTimeout": 10000, "restartOnFailure": true } } }

On Windows:

// %APPDATA%/Cursor/mcp.json { "mcpServers": { "sound": { "command": "mcp-sound-tool", "args": [], "type": "stdio", "pollingInterval": 5000, "startupTimeout": 10000, "restartOnFailure": true } } }

When installed with pipx, the mcp-sound-tool command will be available in your PATH, so Cursor will be able to find and execute it without specifying the full path.

Sound MCP Usage Guidelines for AI Models

This MCP server provides audio feedback capabilities for AI interactions. It's designed to enhance the user experience by providing clear audio cues that indicate the status of operations without requiring the user to read text.

When to Use Sound Feedback

AI agents should use the sound tools proactively at appropriate moments:

  1. Success Sounds (completion):

    • After a task or command has successfully completed
    • When a significant operation has finished successfully
    • When confirming a user's request has been fulfilled
  2. Error Sounds (error):

    • When a command has failed or encountered an error
    • When warning the user about a problem
    • When an operation couldn't be completed as requested
  3. Notification Sounds (notification):

    • When alerting the user to important information
    • When prompting for user attention or input
    • For status updates on long-running operations

Example Usage

# When a command completes successfully @mcp.tool() def execute_command(command): result = run_command(command) if result.success: play_sound("completion") # Indicate success with audio return "Command executed successfully" else: play_sound("error") # Indicate failure with audio return f"Error: {result.error_message}"

Available Tools

  1. play_sound(sound_type="completion", custom_sound_path=None): Play a sound effect
  2. list_available_sounds(): List all available sound files
  3. install_to_user_dir(): Install sound files to user's config directory

For more details, connect to the MCP server and check the tool descriptions.

Development

For development:

# Install development dependencies pip install -e ".[dev]" # Run tests pytest

Acknowledgments

  • SIAM-TheLegend for creating the original sound-mcp JavaScript implementation that inspired this Python version
  • The MCP protocol developers for creating a powerful standard for AI tool interactions
  • Contributors to the testing and documentation

License

This project is licensed under the MIT License - see the LICENSE file for details.

Publicly Shared Threads0

Discover shared experiences

Shared threads will appear here, showcasing real-world applications and insights from the community. Check back soon for updates!

Share your threads to help others
Related MCPs5
  • Readwise MCP
    Readwise MCP

    Enables seamless integration between Large Language Model clients and Readwise by providing standard...

    1 tools
    Added May 30, 2025
  • DaVinci Resolve MCP
    DaVinci Resolve MCP

    Connect AI coding assistants to DaVinci Resolve via Model Context Protocol, enabling natural languag...

    Added May 30, 2025
  • MindManager MCP Server
    MindManager MCP Server

    Enables programmatic interaction with MindManager on Windows and macOS via the Model Context Protoco...

    9 tools
    Added May 30, 2025
  • MCP Apple Calendars
    MCP Apple Calendars

    Model Context Protocol server enabling AI models to access, create, update, and delete Apple Calenda...

    Added May 30, 2025
  • Kali Linux MCP Server
    Kali Linux MCP Server

    A Kali Linux-based Model Context Protocol (MCP) server enabling execution of returnable commands for...

    5 tools
    Added May 30, 2025