Audio Player MCP Server

Servidor MCP del reproductor de audio

Un servidor de Protocolo de Contexto de Modelo (MCP) que le permite a Claude controlar la reproducción de audio en su computadora.

Características

• Reproduce archivos de audio MP3, WAV y OGG.
• Enumere los archivos de audio disponibles en su directorio de música.
• Detener la reproducción de audio.
• Acceso seguro a archivos con aislamiento de directorio.

Requisitos

• Python 3.10 o superior.
• Claude Desktop (última versión).

Instalación

1. Clonar el repositorio:
   git clone https://github.com/Here-and-Tomorrow-LLC/audio-player-mcp.git
2. Navegue hasta el directorio del repositorio:
   cd audio-player-mcp
3. Instalar el paquete en modo editable:
   pip install -e .

Configuración con Claude Desktop

1. Abra la configuración de Claude Desktop y navegue hasta:
   Developer > Edit Config
2. Localice su archivo de configuración:
   • Mac : ~/Library/Application Support/Claude/claude_desktop_config.json
   • Ventanas : %APPDATA%\Claude\claude_desktop_config.json
3. Agregue la siguiente configuración según su sistema operativo:Mac/Linux:
   { "mcpServers": { "audio-player": { "command": "/path/to/your/venv/bin/python", "args": [ "/path/to/your/audio-player-mcp/src/audio_player_mcp/player.py" ], "env": { "AUDIO_PLAYER_DIR": "/path/to/your/audio/files" } } } }
   Ventanas:
   { "mcpServers": { "audio-player": { "command": "C:\path\to\your\venv\Scripts\python.exe", "args": [ "C:\path\to\your\audio-player-mcp\src\audio_player_mcp\player.py" ], "env": { "AUDIO_PLAYER_DIR": "C:\path\to\your\audio\files" } } } }
   Nota: Si AUDIO_PLAYER_DIR no está configurado, el servidor utilizará de manera predeterminada la carpeta Music en su directorio de inicio.
4. Reinicie Claude Desktop.

Uso

Ahora puedes controlar la reproducción de audio preguntándole a Claude:

• "¿Qué archivos de audio tengo?"
• "Reproducir canción.mp3."
• "Detén la música."

Solución de problemas

Si algo no funciona, revise los registros de Claude:

• Impermeable:
  tail -f ~/Library/Logs/Claude/mcp*.log
• Ventanas:
  type "%APPDATA%\Claude\logs\mcp*.log"

Desarrollo

1. Clonar el repositorio:
   git clone https://github.com/yourusername/audio-player-mcp.git
2. Navegue hasta el directorio del repositorio:
   cd audio-player-mcp
3. Instalar dependencias de desarrollo:
   pip install -e ".[dev]"
4. Ejecute el servidor MCP en modo de desarrollo:
   mcp dev src/audio_player_mcp/player.py

Licencia

Este proyecto está licenciado bajo la licencia MIT .