Audio Player

Um servidor MCP para controlar a reprodução de arquivos de áudio locais.

GitHub

Documentação

Audio Player MCP Server

Um servidor Model Context Protocol (MCP) que permite ao Claude controlar a reprodução de áudio no seu computador.

Recursos

Reproduzir arquivos de áudio MP3, WAV e OGG.
Listar arquivos de áudio disponíveis no seu diretório de música.
Parar a reprodução de áudio.
Acesso seguro a arquivos com isolamento de diretório.

Requisitos

Python 3.10 ou superior.
Claude Desktop (versão mais recente).

Instalação

Clone o repositório:

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

Navegue até o diretório do repositório:
```
cd audio-player-mcp
```
Instale o pacote em modo editável:
```
pip install -e .
```

Configuração com Claude Desktop

Abra as configurações do Claude Desktop e navegue até:
Developer > Edit Config
Localize o seu arquivo de configuração:
- Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json

Adicione a seguinte configuração de acordo com o seu sistema operacional:

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: Se AUDIO_PLAYER_DIR não estiver definido, o servidor usará por padrão a pasta Music no seu diretório pessoal.

Reinicie o Claude Desktop.

Uso

Agora você pode controlar a reprodução de áudio pedindo ao Claude:

"Quais arquivos de áudio eu tenho?"
"Toque song.mp3."
"Pare a música."

Solução de problemas

Se algo não estiver funcionando, verifique os logs do Claude:

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

Desenvolvimento

Clone o repositório:

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

Navegue até o diretório do repositório:
```
cd audio-player-mcp
```
Instale as dependências de desenvolvimento:
```
pip install -e ".[dev]"
```
Execute o servidor MCP em modo de desenvolvimento:
```
mcp dev src/audio_player_mcp/player.py
```

Licença

Este projeto está licenciado sob a Licença MIT.