Audio Player
About
Enables audio playback control on your computer through a secure, directory-isolated interface that can play MP3, WAV, and OGG files from a designated folder.
Details
- Author
- here-and-tomorrow-llc
- Repository
- Here-and-Tomorrow-LLC/audio-player-mcp
- GitHub stars
- 1
- License
- MIT License
- Categories
- Other, Media, File Management, Developer Tools, Design, AI, Infrastructure, Frontend, Security
Jump to
- Play MP3, WAV, and OGG audio files.
- List available audio files in your music directory.
- Stop audio playback.
- Secure file access with directory isolation.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Audio PlayerCommand (node, npx, python, etc.)/path/to/your/venv/bin/pythonArguments-
Argument 1
/path/to/your/audio-player-mcp/src/audio_player_mcp/player.py
Environment-
AUDIO_PLAYER_DIR
/path/to/your/audio/files
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
-
Argument 1
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
You can now control audio playback by asking Claude:
- "What audio files do I have?"
- "Play song.mp3."
- "Stop the music."
1. Open Claude Desktop settings and navigate to:
Developer > Edit Config
2. Locate your configuration file:
- Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
3. 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 the Music folder in your home directory.
4. Restart Claude Desktop.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"audio player": {
"env": {
"AUDIO_PLAYER_DIR": "/path/to/your/audio/files"
},
"args": [
"/path/to/your/audio-player-mcp/src/audio_player_mcp/player.py"
],
"command": "/path/to/your/venv/bin/python"
}
}
}Linux
{
"env": {
"AUDIO_PLAYER_DIR": "/path/to/your/audio/files"
},
"args": [
"/path/to/your/audio-player-mcp/src/audio_player_mcp/player.py"
],
"command": "/path/to/your/venv/bin/python"
}Macos
{
"env": {
"AUDIO_PLAYER_DIR": "/path/to/your/audio/files"
},
"args": [
"/path/to/your/audio-player-mcp/src/audio_player_mcp/player.py"
],
"command": "/path/to/your/venv/bin/python"
}Windows
{
"env": {
"AUDIO_PLAYER_DIR": "C:\\path\\to\\your\\audio\\files"
},
"args": [
"C:\\path\\to\\your\\audio-player-mcp\\src\\audio_player_mcp\\player.py"
],
"command": "C:\\path\\to\\your\\venv\\Scripts\\python.exe"
}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
1. Clone the repository:
git clone https://github.com/Here-and-Tomorrow-LLC/audio-player-mcp.git
2. Navigate to the repository directory:
cd audio-player-mcp
3. Install the package in editable mode:
pip install -e .
Setup with Claude Desktop
1. Open Claude Desktop settings and navigate to:
Developer > Edit Config
2. Locate your configuration file:
- Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
3. 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 the Music folder in your home directory.
4. 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.log
- Windows:
type "%APPDATA%\Claude\logs\mcp.log"
Development
1. Clone the repository:
git clone https://github.com/yourusername/audio-player-mcp.git
2. Navigate to the repository directory:
cd audio-player-mcp
3. Install development dependencies:
pip install -e ".[dev]"
4. Run the MCP server in development mode:
mcp dev src/audio_player_mcp/player.py
License
This project is licensed under the MIT License.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
