Audio Player

🚀 Audio Player MCP Server

This is a Model Context Protocol (MCP) server that allows Claude to control audio playback on your computer.

🚀 Quick Start

The Audio Player MCP Server enables Claude to manage audio playback on your computer. It supports various audio formats and provides a secure way to access audio files.

✨ Features

• Play audio files in MP3, WAV, and OGG formats.
• List available audio files in the music directory.
• Stop audio playback.
• Ensure file access security through directory isolation.

📦 Installation

Prerequisites

• Python 3.10 or higher.
• Claude Desktop (latest version).

Steps

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 .
   

📚 Configuration with Claude Desktop

1. Open Claude Desktop settings and navigate to:
   Developers > Edit Configuration

2. Locate the configuration file based on your operating system:

   • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

3. Add the following configuration, adjusting according to 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"
         }
       }
     }
   }
   

   ⚠️ Important 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 Examples

Basic Usage

Now you can let Claude control audio playback:

• “What audio files do I have?”
• “Play song.mp3.”
• “Stop the music.”

🛠️ Troubleshooting

If you encounter issues, 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.