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:
- Navigate to the repository directory:
- Install the package in editable mode:
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:Note: If
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:
- Windows:
Development
- Clone the repository:
- Navigate to the repository directory:
- Install development dependencies:
- Run the MCP server in development mode:
License
This project is licensed under the MIT License.
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
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.
Related MCP Servers
- AsecurityAlicenseAqualityA server that connects Claude with Spotify, allowing users to control playback, search content, get information about tracks/albums/artists/playlists, and manage the Spotify queue.Last updated -4420PythonMIT License
- -securityAlicense-qualityEnables Claude and other AI assistants to interact with your computer's audio system, allowing for recording from microphones and playing audio through speakers.Last updated -3PythonMIT License
- -securityAlicense-qualityA server that lets Claude desktop app execute terminal commands on your computer and edit files through Model Context Protocol, featuring command execution, process management, and advanced file operations.Last updated -38,0053MIT License
- -securityFlicense-qualityAn MCP server that connects Claude to FL Studio, allowing the AI to compose music, control instruments, and live record melodies, chords, and drums to the piano roll.Last updated -46Python