Summary
Deliberately tiny, and the directory boundary is the whole security model.
Three operations and one setting. The setting is the one that matters: AUDIO_PLAYER_DIR is both where the files come from and the limit of what the server can touch, so pointing it at a music folder rather than a home directory is the entire configuration decision. If it is unset the default is your Music folder, which is a reasonable place to land.
What it is
A small local audio player exposed over MCP. It plays MP3, WAV and OGG files from a directory you nominate, and nothing outside it.
What you get
- Play an MP3, WAV or OGG file by name
- List the audio files available in your music directory
- Stop playback
- File access is isolated to the configured directory
Requirements
Python 3.10 or higher. Clone the repository and `pip install -e .`, then point your client at `src/audio_player_mcp/player.py`. AUDIO_PLAYER_DIR names the folder it may play from; without it, the server falls back to the Music folder in your home directory.