list_audio_devicesLABSCO SUMMARY
The assistant gets ears and a voice channel to your desk.
Everything runs locally against real hardware, so a recording is a file on your own disk rather than an upload. Worth knowing before you plan around it: text-to-speech is not implemented, so this is capture and playback, not speech.
What it is
A Python server that connects an MCP client to the audio hardware on your machine. It enumerates the input and output devices, records from a chosen microphone at a duration and sample rate you set, and plays audio back through the speakers.
What you get
- Every microphone and speaker on the system, listed with the index you address it by
- A recording from any input device, with duration and quality set per call
- The most recent recording played straight back
- An audio file on disk played through the speakers
- Text-to-speech is named in the README as a placeholder for later, not a working call
Requirements
Python 3.8 or newer, and audio input and output devices on the machine. It runs as a local process, so the client and the hardware have to be on the same computer. A setup script generates the client configuration for you.
Setup effort
Build from source — git clone https://github.com/GongRzhe/Audio-MCP-Server.git
USE CASES
01
Working out which microphone is which
List the input and output devices with their indexes, so the next call records from the one you meant.
02
Capturing a quick voice note
Record for the number of seconds you name, then hear it back to check it caught anything.
03
Listening to a file without leaving the conversation
Point playback at the path on disk and it comes out of the speakers you chose.
04
Checking an audio pipeline end to end
Record on one device and play back through another to confirm both halves work before you build on them.
5 tools
Listed in project docs. Your client may show a different list.
record_audioplay_latest_recordingplay_audioplay_audio_fileBEFORE YOU INSTALL
What to know first
Tools you get
5 tools named in the project's documentation.
Requires
Python 3.8 or later
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
You clone this one yourself.
Server setup
TERMINAL
git clone https://github.com/GongRzhe/Audio-MCP-Server.git
cd Audio-MCP-Server
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python setup_mcp.pyMCP Clients
Any MCP client
ANY MCP CLIENT · JSON
{
"mcpServers": {
"audio-interface": {
"command": "<YOUR_PATH_TO_VENV>/bin/python",
"args": [
"<YOUR_PATH_TO_AUDIO_SERVER>"
],
"env": {
"PYTHONPATH": "<YOUR_PATH_TO_AUDIO_MCP_SERVER>"
}
}
}
}
