home / mcp / audio player mcp server

Audio Player MCP Server

Provides an MCP server to browse, play, and stop audio files from Claude with secure directory isolation.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "here-and-tomorrow-llc-audio-player-mcp": {
      "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"
      }
    }
  }
}

This MCP server lets Claude control audio playback on your computer. You can browse your music directory, play files, and stop playback from conversational prompts, with directory isolation to keep file access secure.

How to use

Use Claude to list available audio files, start playback of a chosen file, or stop the current track. You can say things like: “What audio files do I have?” to browse, “Play song.mp3” to start a track, or “Stop the music” to halt playback. The server keeps your file access secure by isolating access to a specific music directory you configure.

How to install

{
  "mcpServers": {
    "audio_player_mac": {
      "type": "stdio",
      "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"
      }
    },
    "audio_player_windows": {
      "type": "stdio",
      "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"
      }
    }
  }
}

Additional steps

Prerequisites: Python 3.10 or higher is required to run the server. Ensure you have a compatible Claude Desktop version installed to connect via the MCP.

Install the MCP server package in editable mode from its source directory. Run these commands in your terminal or command prompt (adapt paths to your environment):

pip install -e .

Configure Claude Desktop to use the MCP server

Open Claude Desktop settings and locate the MCP configuration area. Add a new MCP server entry using the macOS/Linux or Windows blocks above, depending on your system. Ensure the environment variable AUDIO_PLAYER_DIR points to your music folder, and restart Claude Desktop to apply changes.

Usage tips

Ask Claude to list your audio files to see what’s available
Ask Claude to play a specific file by name (e.g., Play song.mp3)
Ask Claude to stop playback when needed

Troubleshooting

If playback isn’t starting, check Claude’s logs for MCP-related messages. Look for entries that reference the audio player MCP server to confirm it’s being reached and that the file path is valid within the configured AUDIO_PLAYER_DIR.

Development

If you want to develop locally, install development dependencies and run the MCP server in development mode according to your setup, ensuring you point to the correct script path for your environment.

Available tools

list_audio

Lists available audio files in the configured music directory so you can see what you can play.

play_audio

Plays a selected audio file by name, triggering playback through the MCP server.

stop_audio

Stops the current audio playback immediately.