Audio Player

Un servidor MCP para controlar la reproducción de archivos de audio locales.

Documentación

Servidor MCP de Audio Player

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

Características

Reproduce archivos de audio MP3, WAV y OGG.
Lista los archivos de audio disponibles en tu directorio de música.
Detiene 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

Clona el repositorio:

git clone https://github.com/Here-and-Tomorrow-LLC/audio-player-mcp.git

Navega al directorio del repositorio:
```
cd audio-player-mcp
```
Instala el paquete en modo editable:
```
pip install -e .
```

Configuración con Claude Desktop

Abre la configuración de Claude Desktop y navega a:
Developer > Edit Config
Localiza tu archivo de configuración:
- Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json

Agrega la siguiente configuración según tu 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"
      }
    }
  }
}

Windows:

{
  "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 usará por defecto la carpeta Music en tu directorio de inicio.

Reinicia Claude Desktop.

Uso

Ahora puedes controlar la reproducción de audio pidiéndole a Claude:

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

Solución de problemas

Si algo no funciona, revisa los registros de Claude:

Mac:
```
tail -f ~/Library/Logs/Claude/mcp*.log
```
Windows:
```
type "%APPDATA%\Claude\logs\mcp*.log"
```

Desarrollo

Clona el repositorio:

git clone https://github.com/yourusername/audio-player-mcp.git

Navega al directorio del repositorio:
```
cd audio-player-mcp
```
Instala las dependencias de desarrollo:
```
pip install -e ".[dev]"
```
Ejecuta el servidor MCP en modo de desarrollo:
```
mcp dev src/audio_player_mcp/player.py
```

Licencia

Este proyecto está licenciado bajo la Licencia MIT.