Audio Player MCP Server
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:Copy
- Navigate to the repository directory:Copy
- Install the package in editable mode:Copy
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
- Mac:
- Add the following configuration based on your operating system:Mac/Linux:Windows:CopyNote: IfCopy
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:Copy
- Windows:Copy
Development
- Clone the repository:Copy
- Navigate to the repository directory:Copy
- Install development dependencies:Copy
- Run the MCP server in development mode:Copy
License
This project is licensed under the MIT License.
This server cannot be installed
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.