# Audio File Mcp App

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

- **Type:** MCP server
- **Install:** `agentstack add mcp-counterpoint-studio-audio-file-mcp-app`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [counterpoint-studio](https://agentstack.voostack.com/s/counterpoint-studio)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** ISC
- **Upstream author:** [counterpoint-studio](https://github.com/counterpoint-studio)
- **Source:** https://github.com/counterpoint-studio/audio-file-mcp-app

## Install

```sh
agentstack add mcp-counterpoint-studio-audio-file-mcp-app
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Audio File MCP App

An [MCP App](https://blog.modelcontextprotocol.io/posts/2026-01-26-mcp-apps/)
for playing and inspecting local audio files in an MCP host.

Renders an in-conversation UI with playback, metadata, loudness, and a
spectrogram.

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

## Features

- **Global loudness metrics** computed to EBU R128: Integrated Loudness
  (LUFS), Loudness Range (LRA), True Peak (dBTP), Sample Peak, and RMS.
- **Instantaneous loudness metrics** while playing or hovering: Momentary
  (400 ms) and Short-Term (3 s) LUFS, plus sample-peak and RMS at the
  cursor position.
- **Waveform colouring** by spectral centroid — each waveform slice is
  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.
- **Reassigned spectrogram** with log-frequency bins (20 Hz floor) and an
  Inferno colour scale; time-frequency reassignment sharpens transients
  and tonal partials beyond what a plain STFT shows.
- **Looping region selection.** Drag on the timeline to mark a region;
  playback loops over it, and the region's start/end are passed back to
  the model alongside the file's loudness and playhead state.

## 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](https://github.com/counterpoint-studio/audio-file-mcp-app/releases/latest)
and double-click it. Claude Desktop has Node bundled, so no extra runtime
is needed.

Or add the server by hand to `claude_desktop_config.json`:

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

### VS Code (Copilot, Agent mode)

[](https://insiders.vscode.dev/redirect/mcp/install?name=audio-file&config=%7B%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40counterpoint-studio%2Faudio-file-mcp-app%22%5D%7D)

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

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

```bash
npx @modelcontextprotocol/inspector npx -y @counterpoint-studio/audio-file-mcp-app
```

## Usage

Ask the host to show you a local audio file by its absolute path. For
example:

> "Show me `/Users/me/Music/track.wav`"

The host calls the `display_audio_file` tool, which renders the in-app UI
with waveform, spectrogram, loudness metrics, and playback transport.

## Client compatibility

Tested and known to work in:

- **Claude Desktop** — Chat and Cowork
- **Visual Studio Code**
- **Goose**
- **MCP Inspector**

The Codex app has been tested too, but
[its MCP App support is currently broken](https://github.com/openai/codex/issues/21019).

## Development

```bash
pnpm install
pnpm run build:dsp   # emsdk required; see WASM-BUILD.md
pnpm run serve       # runs the server with tsx, no compile step
pnpm test
```

`pnpm run build:dist` produces the publishable layout under `dist/`
(`dist/mcp-app.html` + `dist/server/`).

## Releasing

```bash
pnpm version                                  # bumps package.json + tags
pnpm publish --access public                        # publishes to npm
pnpm run build:mcpb                                 # produces dist/audio-file-mcp-app-.mcpb
gh release create v dist/*.mcpb           # attaches the bundle to a GitHub release
mcp-publisher login github && mcp-publisher publish # updates the MCP Registry listing
```

`mcp-publisher` is a Go binary; install it via
`brew install mcp-publisher` or per the
[registry quickstart](https://modelcontextprotocol.io/registry/quickstart).
It reads `server.json` from the repo root — keep its `version` in sync with
`package.json` before publishing.

## License

ISC © Counterpoint Studio OÜ

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [counterpoint-studio](https://github.com/counterpoint-studio)
- **Source:** [counterpoint-studio/audio-file-mcp-app](https://github.com/counterpoint-studio/audio-file-mcp-app)
- **License:** ISC

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-counterpoint-studio-audio-file-mcp-app
- Seller: https://agentstack.voostack.com/s/counterpoint-studio
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.