Audio File MCP App MCP server

Audio File MCP App

An MCP App for playing and inspecting local audio files in an MCP host.

Renders an in-conversation UI with playback, metadata, loudness, a spectrogram, and an optional annotation-lane timeline.

File metadata, loudness statistics, the current playhead position, any selected region, and the annotation lanes active at the playhead are also exposed back to the model, so follow-up tasks can refer to what the user is actually hearing and looking at.

Features

(LUFS), Loudness Range (LRA), True Peak (dBTP), Sample Peak, and RMS.

• Global loudness metrics computed to EBU R128: Integrated Loudness

(400 ms) and Short-Term (3 s) LUFS, plus sample-peak and RMS at the cursor position.

• Instantaneous loudness metrics while playing or hovering: Momentary

shaded along a tonal ramp using a low/mid/high band-energy ratio, so bright/dark regions read at a glance as bright/dark sound.

• Waveform colouring by spectral centroid — each waveform slice is

Inferno colour scale; time-frequency reassignment sharpens transients and tonal partials beyond what a plain STFT shows.

• Reassigned spectrogram with log-frequency bins (20 Hz floor) and an

playback loops over it, and the region's start/end are passed back to the model alongside the file's loudness and playhead state.

• Looping region selection. Drag on the timeline to mark a region;

draws a stack of thin labelled lanes between the waveform and spectrogram, aligned to the audio's own timeline. Each lane carries time spans, an optional colour, and an optional envelope that fades span opacity along the lane. Hovering a span reveals its label, and the lanes active at the playhead — plus those starting, ending, or active within a selected region — are reported back to the model.

• Annotation-lane timeline. Supply timeline annotations and the widget

Install

The server runs locally over stdio. Every install path below configures the same command: npx -y @counterpoint-studio/audio-file-mcp-app.

Claude Desktop

Easiest: grab the latest .mcpb from the Releases page and double-click it. Claude Desktop has Node bundled, so no extra runtime is needed.

Or add the server by hand to claudedesktopconfig.json:

{
  "mcpServers": {
    "audio-file": {
      "command": "npx",
      "args": ["-y", "@counterpoint-studio/audio-file-mcp-app"]
    }
  }
}

Codex Desktop

1. Go to Settings -> MCP Servers
2. Add Server
3. Name: audiofile-mcp-app
4. Command to launch: npx
5. Arguments -y and @counterpoint-studio/audio-file-mcp-app

VS Code (Copilot, Agent mode)

Or add to .vscode/mcp.json (workspace) or your user mcp.json:

{
  "servers": {
    "audio-file": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@counterpoint-studio/audio-file-mcp-app"]
    }
  }
}

Goose

Paste this deep link into your browser (Goose Desktop must be installed; the custom URI scheme can't be a real link in a GitHub README):

goose://extension?id=audio-file&name=Audio%20File%20MCP%20App&cmd=npx&arg=-y&arg=%40counterpoint-studio%2Faudio-file-mcp-app

Or run goose configure → Add Extension → Command-line Extension and enter npx -y @counterpoint-studio/audio-file-mcp-app.

MCP Inspector

Shortened. The full README is on GitHub.