Audioport

io.github.CloudCorpRecordsPublished by GitHub account CloudCorpRecordsv0.1.0Updated Nov 3, 2026

Audio metadata, conversion, trimming, normalization, and transcription via ffmpeg.

VerifiedSTDIODesktop only

Overview

Audioport's local MCP server; no sign-in required; STDIO.

No AI overview yet: these facts come from the registry entry and the server itself.

Installation

In SourceWeft

  1. Open Audioport in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

audioport

audioport does everyday audio work on local files. It reads the facts ffprobe reports about a file — its format, duration, bit rate, sample rate, and channel count — converts between the common audio formats, cuts a segment out of a file starting at a chosen second, and normalizes loudness with ffmpeg's loudnorm filter. A fifth tool transcribes, but only through a transcription engine you configure yourself; audioport bundles no engine and invents no transcripts.

All processing runs through the ffmpeg and ffprobe binaries on the machine, invoked with argument arrays (never a shell), so those binaries must be installed for the processing tools to work. When they are missing, the binary's own error is returned instead of a made-up result.

Transcription

Transcription is delegated to a local command named by the AUDIOPORT_TRANSCRIBER_COMMAND environment variable. The command is run with the audio file path as its last argument, and its stdout is the transcript. For example:

bash
export AUDIOPORT_TRANSCRIBER_COMMAND="whisper-cli --model base"

When the variable is unset, transcribe and the transcribe_audio tool fail with an error naming AUDIOPORT_TRANSCRIBER_COMMAND. There is no API key, no hosted service, and no fallback that guesses at the words.

Install

bash
npx @reneturcios/audioport metadata song.mp3

Or run the container image:

bash
docker run -i ghcr.io/cloudcorprecords/audioport

The container defaults to the MCP server (see below) and bundles no ffmpeg/ffprobe; use a host install, or a derived image with ffmpeg installed, for the processing tools. Pass CLI arguments to use it as a CLI instead.

CLI

bash
audioport metadata song.mp3audioport convert song.wav song-out.mp3 mp3 --bitrate 192kaudioport trim song.mp3 clip.mp3 5 --duration 10audioport normalize song.wav song-normalized.wavaudioport transcribe song.mp3 --language en
audioport --version

The convert command writes to the output path with its extension replaced by the target format when they differ (converting song-out.ogg to mp3 writes song-out.mp3). Supported formats: mp3, wav, ogg, flac, aac, m4a.

Each command prints its result as JSON. Exit codes: 0 on success, 1 when processing fails (including a missing transcription engine), 2 for usage errors.

MCP server

One bin serves both faces. The mcp subcommand starts a stdio MCP server:

bash
npx -y @reneturcios/audioport mcp

MCP client configuration:

json
{  "mcpServers": {    "audioport": {      "command": "npx",      "args": ["-y", "@reneturcios/audioport", "mcp"],      "env": { "AUDIOPORT_TRANSCRIBER_COMMAND": "whisper-cli --model base" }    }  }}

Tools

ToolInputWhat it returns
get_audio_metadatainput (required)Format, duration in seconds, bit rate, sample rate, and channels; fields ffprobe did not provide are null.
convert_audioinput, output, format (required), bitrate (optional)The effective output path (extension follows the format), format, and bit rate.
trim_audioinput, output, start (required), duration (optional)The output path, start second, and duration.
normalize_audioinput, output (required)The input and output paths, after a loudnorm pass.
transcribe_audioinput (required), language (optional)The transcript from the configured engine, or an error naming AUDIOPORT_TRANSCRIBER_COMMAND when none is configured.

Development

bash
npm installnpm run build   # tsc -> dist/npm test        # node test runner over test/*.test.ts, fake executors onlynpm run dev     # run the CLI from source via tsx

License

MIT — see LICENSE.

Source: README.md at commit 7989b7b

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.0LatestNov 3, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts