Skip to main content
Glama
deenesjakoruzh

Audio MCP Server

by GongRzhe
GitHub
Python
MIT License
3
  • Linux
  • Apple
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Audio MCP Server

An MCP (Model Context Protocol) server that provides audio input/output capabilities for AI assistants like Claude. This server enables Claude to interact with your computer's audio system, including recording from microphones and playing audio through speakers.

Features

  • List Audio Devices: View all available microphones and speakers on your system
  • Record Audio: Capture audio from any microphone with customizable duration and quality
  • Playback Recordings: Play back your most recent recording
  • Audio File Playback: Play audio files through your speakers
  • Text-to-Speech: (Placeholder for future implementation)

Requirements

  • Python 3.8 or higher
  • Audio input/output devices on your system

Installation

Installing via Smithery

To install Audio Interface Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @GongRzhe/Audio-MCP-Server --client claude

Manual Installation

  1. Clone this repository or download the files to your computer:
git clone https://github.com/GongRzhe/Audio-MCP-Server.git cd Audio-MCP-Server
  1. Create a virtual environment and install dependencies:
# Windows python -m venv .venv .venv\Scripts\activate pip install -r requirements.txt # macOS/Linux python -m venv .venv source .venv/bin/activate pip install -r requirements.txt
  1. Or use the included setup script to automate installation:
python setup_mcp.py

Configuration

Claude Desktop Configuration

To use this server with Claude Desktop, add the following to your Claude Desktop configuration file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{ "mcpServers": { "audio-interface": { "command": "/path/to/your/.venv/bin/python", "args": [ "/path/to/your/audio_server.py" ], "env": { "PYTHONPATH": "/path/to/your/audio-mcp-server" } } } }

Replace the paths with the actual paths on your system. The setup script will generate this configuration for you.

Usage

After setting up the server, restart Claude Desktop. You should see a hammer icon in the input box, indicating that tools are available.

Try asking Claude:

  • "What microphones and speakers are available on my system?"
  • "Record 5 seconds of audio from my microphone."
  • "Play back the audio recording."
  • "Play an audio file from my computer."

Available Tools

list_audio_devices

Lists all available audio input and output devices on your system.

record_audio

Records audio from your microphone.

Parameters:

  • duration: Recording duration in seconds (default: 5)
  • sample_rate: Sample rate in Hz (default: 44100)
  • channels: Number of audio channels (default: 1)
  • device_index: Specific input device index to use (default: system default)

play_latest_recording

Plays back the most recently recorded audio.

play_audio

Placeholder for text-to-speech functionality.

Parameters:

  • text: The text to convert to speech
  • voice: The voice to use (default: "default")

play_audio_file

Plays an audio file through your speakers.

Parameters:

  • file_path: Path to the audio file
  • device_index: Specific output device index to use (default: system default)

Troubleshooting

No devices found

If no audio devices are found, check:

  • Your microphone and speakers are properly connected
  • Your operating system recognizes the devices
  • You have the necessary permissions to access audio devices

Playback issues

If audio playback isn't working:

  • Check your volume settings
  • Ensure the correct output device is selected
  • Try restarting the Claude Desktop application

Server connectivity

If Claude can't connect to the server:

  • Verify your configuration paths are correct
  • Ensure Python and all dependencies are installed
  • Check Claude's logs for error messages

License

MIT

Acknowledgments

Note: This server provides tools that can access your microphone and speakers. Always review and approve tool actions before they execute.

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Enables Claude and other AI assistants to interact with your computer's audio system, allowing for recording from microphones and playing audio through speakers.

  1. Features
    1. Requirements
      1. Installation
        1. Installing via Smithery
        2. Manual Installation
      2. Configuration
        1. Claude Desktop Configuration
      3. Usage
        1. Available Tools
          1. list_audio_devices
          2. record_audio
          3. play_latest_recording
          4. play_audio
          5. play_audio_file
        2. Troubleshooting
          1. No devices found
          2. Playback issues
          3. Server connectivity
        3. License
          1. Acknowledgments

            Related MCP Servers

            • MCP Unified Server

              getfounded
              -
              security
              A
              license
              -
              quality
              A modular server implementation for Claude AI assistants with integrated tools, enabling Claude to perform actions and access external resources like file systems, web searches, browser automation, financial data, and document generation.
              Last updated -
              90
              Python
              MIT License
              • Linux
              • Apple

            • Audio Player MCP Server

              Here-and-Tomorrow-LLC
              -
              security
              A
              license
              -
              quality
              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.
              Last updated -
              3
              Python
              MIT License
              • Apple
              • Linux

            • Voicevox MCP Server

              Dosugamea
              A
              security
              A
              license
              A
              quality
              A server that enables Claude 3.7 and other AI agents to access VOICEVOX-compatible speech synthesis engines (AivisSpeech, VOICEVOX, COEIROINK) through the Model Context Protocol.
              Last updated -
              1
              10
              TypeScript
              MIT License
              • Linux

            • Interactive Voice MCP Server

              rungee84
              -
              security
              F
              license
              -
              quality
              Enables voice-based interactions with Claude by converting text to speech using Kokoro TTS and transcribing user responses using NVIDIA NeMo ASR, creating interactive voice dialogues.
              Last updated -
              Python

            View all related MCP servers

            New MCP Servers

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/GongRzhe/Audio-MCP-Server'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server