Audio Player MCP Server
A Model Context Protocol (MCP) server that allows Claude to control audio playback on your computer.
Features
Play MP3, WAV, and OGG audio files.
List available audio files in your music directory.
Stop audio playback.
Secure file access with directory isolation.
Requirements
Python 3.10 or higher.
Claude Desktop (latest version).
Installation
Clone the repository:
git clone https://github.com/Here-and-Tomorrow-LLC/audio-player-mcp.gitNavigate to the repository directory:
cd audio-player-mcpInstall the package in editable mode:
pip install -e .
Setup with Claude Desktop
Open Claude Desktop settings and navigate to:
Developer > Edit Config
Locate your configuration file:
Mac:
~/Library/Application Support/Claude/claude_desktop_config.json
Windows:
%APPDATA%\Claude\claude_desktop_config.json
Add the following configuration based on your operating system:
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" } } } }Note: If
AUDIO_PLAYER_DIR
is not set, the server will default to using theMusic
folder in your home directory.Restart Claude Desktop.
Usage
You can now control audio playback by asking Claude:
"What audio files do I have?"
"Play song.mp3."
"Stop the music."
Troubleshooting
If something isn't working, check Claude's logs:
Mac:
tail -f ~/Library/Logs/Claude/mcp*.logWindows:
type "%APPDATA%\Claude\logs\mcp*.log"
Development
Clone the repository:
git clone https://github.com/yourusername/audio-player-mcp.gitNavigate to the repository directory:
cd audio-player-mcpInstall development dependencies:
pip install -e ".[dev]"Run the MCP server in development mode:
mcp dev src/audio_player_mcp/player.py
License
This project is licensed under the MIT License.
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
A server that allows Claude to control audio playback on your computer, supporting MP3, WAV, and OGG files with features like play, list, and stop commands.
Related MCP Servers
- AsecurityAlicenseAqualityA server that connects Claude with Spotify, allowing users to control playback, search content, get information about tracks/albums/artists/playlists, and manage the Spotify queue.Last updated -486MIT License
- -securityAlicense-qualityEnables Claude and other AI assistants to interact with your computer's audio system, allowing for recording from microphones and playing audio through speakers.Last updated -4MIT License
- AsecurityAlicenseAqualityA server that lets Claude desktop app execute terminal commands on your computer and edit files through Model Context Protocol, featuring command execution, process management, and advanced file operations.Last updated -1917,5414MIT License
- -securityFlicense-qualityAn MCP server that connects Claude to FL Studio, allowing the AI to compose music, control instruments, and live record melodies, chords, and drums to the piano roll.Last updated -56