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.git

Navigate to the repository directory:
```
cd audio-player-mcp
```
Install 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 the Music 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*.log
```
Windows:
```
type "%APPDATA%\Claude\logs\mcp*.log"
```

Development

Clone the repository:

git clone https://github.com/yourusername/audio-player-mcp.git

Navigate to the repository directory:
```
cd audio-player-mcp
```
Install 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.

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 the Music folder in your home directory.

Restart Claude Desktop.