Server data from the Official MCP Registry
Audio metadata, conversion, trimming, normalization, and transcription via ffmpeg.
About
Audio metadata, conversion, trimming, normalization, and transcription via ffmpeg.
Security Report
audioport is a local ffmpeg/ffprobe wrapper with no network calls, no hardcoded secrets, and no shell invocation; all commands use execFile argument arrays and inputs are validated with zod. The main concerns are low-severity: the -y flag silently overwrites existing output files, and user-supplied paths are not constrained or checked for leading dashes that ffmpeg could interpret as options. Permissions (file read/write, spawning ffmpeg/ffprobe and the operator-configured transcriber, and reading AUDIOPORT_TRANSCRIBER_COMMAND) match the stated purpose. Supply chain analysis found 4 known vulnerabilities in dependencies (0 critical, 2 high severity). Package verification found 1 issue.
8 files analyzed · 9 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
What You'll Need
Set these up before or after installing:
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-cloudcorprecords-audioport": {
"env": {
"AUDIOPORT_TRANSCRIBER_COMMAND": "your-audioport-transcriber-command-here"
},
"args": [
"-y",
"@reneturcios/audioport"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub 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:
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
npx @reneturcios/audioport metadata song.mp3
Or run the container image:
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
audioport metadata song.mp3
audioport convert song.wav song-out.mp3 mp3 --bitrate 192k
audioport trim song.mp3 clip.mp3 5 --duration 10
audioport normalize song.wav song-normalized.wav
audioport 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:
npx -y @reneturcios/audioport mcp
MCP client configuration:
{
"mcpServers": {
"audioport": {
"command": "npx",
"args": ["-y", "@reneturcios/audioport", "mcp"],
"env": { "AUDIOPORT_TRANSCRIBER_COMMAND": "whisper-cli --model base" }
}
}
}
Tools
| Tool | Input | What it returns |
|---|---|---|
get_audio_metadata | input (required) | Format, duration in seconds, bit rate, sample rate, and channels; fields ffprobe did not provide are null. |
convert_audio | input, output, format (required), bitrate (optional) | The effective output path (extension follows the format), format, and bit rate. |
trim_audio | input, output, start (required), duration (optional) | The output path, start second, and duration. |
normalize_audio | input, output (required) | The input and output paths, after a loudnorm pass. |
transcribe_audio | input (required), language (optional) | The transcript from the configured engine, or an error naming AUDIOPORT_TRANSCRIBER_COMMAND when none is configured. |
Development
npm install
npm run build # tsc -> dist/
npm test # node test runner over test/*.test.ts, fake executors only
npm run dev # run the CLI from source via tsx
License
MIT — see LICENSE.
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Rea
Freeby Morluto · Developer Tools
Reverse engineer anything from your terminal or agent with one CLI and MCP server.
Paperclip
Freeby Paperclipai · Developer Tools
Trending hip-hop artist momentum scores across four cultural dimensions.
Fetch
Freeby Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.