Herramienta de sonido MCP

Una implementación del Protocolo de Contexto de Modelo (MCP) que reproduce efectos de sonido para Cursor AI y otros entornos compatibles con MCP. Esta implementación de Python proporciona retroalimentación de audio para una experiencia de programación más interactiva.

Características

Reproduce efectos de sonido para varios eventos (finalización, error, notificación)
Utiliza el Protocolo de contexto de modelo (MCP) para la integración estandarizada con Cursor y otros IDE
Compatibilidad multiplataforma (Windows, macOS, Linux)
Efectos de sonido configurables

Instalación

Compatibilidad de versiones de Python

Este paquete se ha probado con Python 3.8-3.11. Si encuentra errores con Python 3.12 o posterior (en particular, excepciones como BrokenResourceError o TaskGroup ), pruebe con una versión anterior de Python.

Recomendado: Instalar con pipx

La forma recomendada de instalar mcp-sound-tool es con pipx , que instala el paquete en un entorno aislado y hace que los comandos estén disponibles globalmente:

# 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

Este método garantiza que la herramienta tenga su propio entorno aislado, evitando conflictos con otros paquetes.

Alternativa: Instalar con pip

También puedes instalarlo directamente con pip:

pip install mcp-sound-tool

De la fuente

Clonar este repositorio:
git clone https://github.com/yourusername/mcp-sound-tool cd mcp-sound-tool
Instalar con pipx directamente desde el directorio de origen:
pipx install .
O con pip:
pip install -e .

Uso

Agregar archivos de sonido

Coloque sus archivos de sonido en el directorio sounds . Se esperan los siguientes archivos de sonido:

completion.mp3 - Se reproduce después de la generación del código
error.mp3 - Se reproduce cuando ocurre un error
notification.mp3 - Se utiliza para notificaciones generales

Puede encontrar efectos de sonido gratuitos en sitios web como freesound.org.

Ejecución del servidor MCP

Ejecute el servidor MCP:

mcp-sound-tool

El servidor se iniciará y escuchará eventos de Cursor u otros clientes compatibles con MCP a través del transporte stdio.

Configuración en el cursor

Para utilizar este servidor con Cursor, agréguelo a su archivo de configuración de MCP:

En macOS:

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

En Windows:

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

Cuando se instala con pipx , el comando mcp-sound-tool estará disponible en su PATH, por lo que Cursor podrá encontrarlo y ejecutarlo sin especificar la ruta completa.

Pautas de uso de Sound MCP para modelos de IA

Este servidor MCP ofrece funciones de retroalimentación de audio para interacciones con IA. Está diseñado para mejorar la experiencia del usuario al proporcionar señales de audio claras que indican el estado de las operaciones sin necesidad de que el usuario lea texto.

Cuándo utilizar la retroalimentación sonora

Los agentes de IA deben utilizar las herramientas de sonido de forma proactiva en los momentos adecuados:

Sonidos de éxito ( completion ) :
- Después de que una tarea o comando se haya completado con éxito
- Cuando una operación importante ha finalizado con éxito
- Al confirmar que se ha cumplido la solicitud de un usuario
Sonidos de error ( error ) :
- Cuando un comando ha fallado o ha encontrado un error
- Al advertir al usuario sobre un problema
- Cuando una operación no se pudo completar según lo solicitado
Sonidos de notificación ( notification ) :
- Al alertar al usuario sobre información importante
- Al solicitar la atención o la entrada del usuario
- Para actualizaciones de estado sobre operaciones de larga duración

Ejemplo de uso

# 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}"

Herramientas disponibles

play_sound(sound_type="completion", custom_sound_path=None) : Reproducir un efecto de sonido
list_available_sounds() : enumera todos los archivos de sonido disponibles
install_to_user_dir() : instala archivos de sonido en el directorio de configuración del usuario

Para obtener más detalles, conéctese al servidor MCP y consulte las descripciones de las herramientas.

Desarrollo

Para desarrollo:

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

# Run tests
pytest

Expresiones de gratitud

SIAM-TheLegend por crear la implementación original de JavaScript sound-mcp que inspiró esta versión de Python
Los desarrolladores del protocolo MCP para crear un estándar poderoso para las interacciones de herramientas de IA
Contribuyentes a las pruebas y documentación

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

MCP Sound Tool