What is Audio Player Mcp

audio-player-mcp is a Model Context Protocol (MCP) server that enables Claude to control audio playback on your computer, allowing for seamless interaction with audio files.

Use cases

Use cases for audio-player-mcp include controlling music playback during presentations, developing audio-based applications, and automating audio playback in personal projects.

How to use

To use audio-player-mcp, clone the repository, install the package in editable mode, and configure it with Claude Desktop by adding the necessary settings in the configuration file. After setup, you can control audio playback through Claude.

Key features

Key features include the ability to play MP3, WAV, and OGG audio files, list available audio files in your music directory, stop audio playback, and ensure secure file access with directory isolation.

Where to use

audio-player-mcp can be used in various fields such as personal entertainment, software development, and audio application integration, particularly where audio playback control is required.

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:

   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.