Audio Interface

by gongrzhe

4 stars

Not rated

GitHub

About

Enables voice interaction with Claude through audio recording and playback capabilities, supporting customizable device selection and temporary file management for accessible spoken communication.

Details

Author: gongrzhe
Repository: GongRzhe/Audio-MCP-Server
GitHub stars: 4
License: MIT License
Categories: Productivity, Developer Tools, Design, File Management, AI, Media, Frontend, Infrastructure, Communication, Other

- 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)

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name Audio Interface

Command (node, npx, python, etc.) /path/to/your/.venv/bin/python
Arguments
- Argument 1 /path/to/your/audio_server.py
Environment
- PYTHONPATH /path/to/your/audio-mcp-server
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "audio interface": {
            "env": {
                "PYTHONPATH": "/path/to/your/audio-mcp-server"
            },
            "args": [
                "/path/to/your/audio_server.py"
            ],
            "command": "/path/to/your/.venv/bin/python"
        }
    }
}

JSON

{
    "mcpServers": {
        "audio interface": {
            "env": {
                "PYTHONPATH": "/path/to/your/audio-mcp-server"
            },
            "args": [
                "/path/to/your/audio_server.py"
            ],
            "command": "/path/to/your/.venv/Scripts/python.exe"
        }
    }
}

JSON

{
    "mcpServers": {
        "audio interface": {
            "env": {
                "PYTHONPATH": "/path/to/your/audio-mcp-server"
            },
            "args": [
                "/path/to/your/audio_server.py"
            ],
            "command": "/path/to/your/.venv/bin/python"
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "audio interface": {
            "env": {
                "PYTHONPATH": "/path/to/your/audio-mcp-server"
            },
            "args": [
                "/path/to/your/audio_server.py"
            ],
            "command": "/path/to/your/.venv/bin/python"
        }
    }
}

JSON

{
    "mcpServers": {
        "audio interface": {
            "env": {
                "PYTHONPATH": "/path/to/your/audio-mcp-server"
            },
            "args": [
                "/path/to/your/audio_server.py"
            ],
            "command": "/path/to/your/.venv/Scripts/python.exe"
        }
    }
}

JSON

{
    "mcpServers": {
        "audio interface": {
            "env": {
                "PYTHONPATH": "/path/to/your/audio-mcp-server"
            },
            "args": [
                "/path/to/your/audio_server.py"
            ],
            "command": "/path/to/your/.venv/bin/python"
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "audio interface": {
            "env": {
                "PYTHONPATH": "/path/to/your/audio-mcp-server"
            },
            "args": [
                "/path/to/your/audio_server.py"
            ],
            "command": "/path/to/your/.venv/bin/python"
        }
    }
}

JSON

{
    "mcpServers": {
        "audio interface": {
            "env": {
                "PYTHONPATH": "/path/to/your/audio-mcp-server"
            },
            "args": [
                "/path/to/your/audio_server.py"
            ],
            "command": "/path/to/your/.venv/Scripts/python.exe"
        }
    }
}

JSON

{
    "mcpServers": {
        "audio interface": {
            "env": {
                "PYTHONPATH": "/path/to/your/audio-mcp-server"
            },
            "args": [
                "/path/to/your/audio_server.py"
            ],
            "command": "/path/to/your/.venv/bin/python"
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "audio interface": {
            "env": {
                "PYTHONPATH": "/path/to/your/audio-mcp-server"
            },
            "args": [
                "/path/to/your/audio_server.py"
            ],
            "command": "/path/to/your/.venv/bin/python"
        }
    }
}

JSON

{
    "mcpServers": {
        "audio interface": {
            "env": {
                "PYTHONPATH": "/path/to/your/audio-mcp-server"
            },
            "args": [
                "/path/to/your/audio_server.py"
            ],
            "command": "/path/to/your/.venv/Scripts/python.exe"
        }
    }
}

JSON

{
    "mcpServers": {
        "audio interface": {
            "env": {
                "PYTHONPATH": "/path/to/your/audio-mcp-server"
            },
            "args": [
                "/path/to/your/audio_server.py"
            ],
            "command": "/path/to/your/.venv/bin/python"
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "audio interface": {
            "env": {
                "PYTHONPATH": "/path/to/your/audio-mcp-server"
            },
            "args": [
                "/path/to/your/audio_server.py"
            ],
            "command": "/path/to/your/.venv/bin/python"
        }
    }
}

JSON

{
    "mcpServers": {
        "audio interface": {
            "env": {
                "PYTHONPATH": "/path/to/your/audio-mcp-server"
            },
            "args": [
                "/path/to/your/audio_server.py"
            ],
            "command": "/path/to/your/.venv/Scripts/python.exe"
        }
    }
}

JSON

{
    "mcpServers": {
        "audio interface": {
            "env": {
                "PYTHONPATH": "/path/to/your/audio-mcp-server"
            },
            "args": [
                "/path/to/your/audio_server.py"
            ],
            "command": "/path/to/your/.venv/bin/python"
        }
    }
}

From the repository

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

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

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

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

2. Create a virtual environment and install dependencies:

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

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.

`list_audio_devices`

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

`record_audio`

Records audio from your microphone. Parameters: duration (int, default: 5), sample_rate (int, default: 44100), channels (int, default: 1), device_index (int, default: system default)

`play_latest_recording`

Plays back the most recently recorded audio.

`play_audio`

Placeholder for text-to-speech functionality. Parameters: text (string), voice (string, default: 'default')

`play_audio_file`

Plays an audio file through your speakers. Parameters: file_path (string), device_index (int, default: system default)

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "audio interface": {
            "env": {
                "PYTHONPATH": "/path/to/your/audio-mcp-server"
            },
            "args": [
                "/path/to/your/audio_server.py"
            ],
            "command": "/path/to/your/.venv/bin/python"
        }
    }
}

Linux

{
    "env": {
        "PYTHONPATH": "/path/to/your/audio-mcp-server"
    },
    "args": [
        "/path/to/your/audio_server.py"
    ],
    "command": "/path/to/your/.venv/bin/python"
}

Macos

{
    "env": {
        "PYTHONPATH": "/path/to/your/audio-mcp-server"
    },
    "args": [
        "/path/to/your/audio_server.py"
    ],
    "command": "/path/to/your/.venv/bin/python"
}

Windows

{
    "env": {
        "PYTHONPATH": "/path/to/your/audio-mcp-server"
    },
    "args": [
        "/path/to/your/audio_server.py"
    ],
    "command": "/path/to/your/.venv/Scripts/python.exe"
}

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.

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

To install Audio Interface Server for Claude Desktop automatically viaSmithery:

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

- Clone this repository or download the files to your computer:

git clone https://github.com/GongRzhe/Audio-MCP-Server.git cd Audio-MCP-Server

- 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

- Or use the included setup script to automate installation:

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.

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

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

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

- 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)

Plays back the most recently recorded audio.

Placeholder for text-to-speech functionality.

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

Plays an audio file through your speakers.

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

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

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

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

- Built using theModel Context Protocol
- Uses sounddeviceand soundfilefor audio processing

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

Upfirst is an AI phone receptionist for small businesses. Review call transcripts, then fix the greeting, knowledge, and transfer rules from your AI client.

Enables communication between multiple AI characters with simultaneous voice playback using VLC.

An MCP server integrating WhatsApp messaging and ElevenLabs AI voice capabilities into VS Code.

Multilingual intelligence + memory + safety + voice layer for autonomous AI agents

Interact with RetellAI's voice services to create conversational voice AI.

A server for natural voice conversations with AI assistants like Claude and ChatGPT.

Integrate AI assistants with VOYP's calling capabilities to make calls, search business info, and manage call status.

Voice AI assistant builder for websites — create and deploy AI voice bots that respond in 50+ languages, 24/7.

A voice-enabled AI personal assistant that integrates multiple tools and services through natural voice interactions using MCP.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

Audio Interface

About

Details

Jump to

Setting up with Highlight

Setting up with Cursor

JSON

JSON

JSON

Setting up with Claude Desktop

JSON

JSON

JSON

Setting up with Windsurf

JSON

JSON

JSON

Setting up with Cline

JSON

JSON

JSON

Setting up with Goose

JSON

JSON

JSON

From the repository

`list_audio_devices`

`record_audio`

`play_latest_recording`

`play_audio`

`play_audio_file`

Claude Desktop / Cursor

Linux

Macos

Windows

Install

About

Details

Jump to

Setting up with Highlight

From the repository

list_audio_devices

record_audio

play_latest_recording

play_audio

play_audio_file

Claude Desktop / Cursor

Linux

Macos

Windows

Install

More like this

Time

Sentry

Github

Git

GitLab

Context 7

`list_audio_devices`

`record_audio`

`play_latest_recording`

`play_audio`

`play_audio_file`