Name: Audio Player
Author: Here-and-Tomorrow-LLC

LABSCO 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.

Setup effort

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

See installation options

USE CASES

01

Playing something without switching apps

Ask for a track by name while you are working in the assistant.

02

Finding out what is in the folder

List the audio files available before asking for one.

03

Stopping it when someone calls

One instruction ends playback.

BEFORE YOU INSTALL

What to know first

Requires

Python 3.10 or later

Where it runs

Both documented setups run the server on your machine.

INSTALLATION

Connect your client

You clone this one yourself.

Server setup

TERMINAL

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

MCP Clients

Claude Desktop — macOS/Linux

CLAUDE DESKTOP — MACOS/LINUX · JSON

{
  "mcpServers": {
    "audio-player": {
      "command": "<YOUR_PATH_TO_VENV>/bin/python",
      "args": [
        "<YOUR_PATH_TO_AUDIO_PLAYER_MCP>/src/audio_player_mcp/player.py"
      ],
      "env": {
        "AUDIO_PLAYER_DIR": "<YOUR_AUDIO_PLAYER_DIR>"
      }
    }
  }
}

Claude Desktop — Windows

CLAUDE DESKTOP — WINDOWS · JSON

{
  "mcpServers": {
    "audio-player": {
      "command": "<YOUR_PATH_TO_VENV>\\Scripts\\python.exe",
      "args": [
        "<YOUR_PATH_TO_AUDIO_PLAYER_MCP>\\src\\audio_player_mcp\\player.py"
      ],
      "env": {
        "AUDIO_PLAYER_DIR": "<YOUR_AUDIO_PLAYER_DIR>"
      }
    }
  }
}

Audio Player