MCP-Audio Plugin

mcp-audio is an AIO-2030 compliant MCP plugin that performs voice-to-text transcription using the Audio speech recognition API.

It exposes the identify_voice method via both multipart/form-data and base64 formats, supports the AIO tools.call protocol, and returns JSON-RPC structured outputs.

Features

Fully AIO-compliant MCP plugin (/tools.call, /help)
Converts .wav/.mp3 audio files to transcripts using SiliconFlow
API key managed securely via .env file
Docker-compatible and minimal dependencies
Registration-ready for AIO endpoint registry

Setup (Local)

1. Clone and Install

git clone git@github.com:AIO-2030/mcp-audio.git
cd mcp-audio
python -m venv venv && source venv/bin/activate
pip install -r requirements.txt

2. Add .env file

cp .env.example .env

Set your audio URL and API key:

AUDIO_URL=https--xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

3. Run the MCP server

python src/mcp_server.py

4. Docker

4.1 Build and Run

docker build -t mcp-audio .
docker run --env-file .env -p 8080:8080 mcp-audio

API Overview

POST /api/v1/mcp/voice_model

Upload audio file directly. Response:

{
  "transcript": "hello world",
  "confidence": 0.91,
  "audio_hash": "a1b2c3..."
}

POST /api/v1/mcp/tools.call (AIO Protocol)

JSON-RPC format with base64-encoded audio. Response:

{
  "method": "tools.call",
  "params": {
    "method": "identify_voice",
    "inputs": [
      {
        "type": "audio",
        "value": "<base64-audio>"
      }
    ]
  }
}

GET /api/v1/mcp/help

Auto-serves contents of mcp_audio_registration.json. Used by Queen AI for MCP discovery and service indexing.

Testing Tools

Base64 Voice Test

python test/test_audio_base64.py

Health Check

python health_check.py

MCP Registration (to AIO Endpoint Canister)

./register_mcp.sh

Requires jq, dfx, and a running endpoint_registry canister.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

A voice-to-text transcription service that converts audio files to transcripts using SiliconFlow, supporting both multipart/form-data and base64 formats.

Related MCP Servers

MS-Lucidia-Voice-Gateway-MCP
ExpressionsBot
-
security
F
license
-
quality
A server providing text-to-speech and speech-to-text functionalities using Windows' native speech services without external dependencies.
Last updated -
4
JavaScript
Kokoro TTS MCP Server
giannisanni
-
security
F
license
-
quality
Provides text-to-speech capabilities through the Model Context Protocol, allowing applications to easily integrate speech synthesis with customizable voices, adjustable speech speed, and cross-platform audio playback support.
Last updated -
7
Python
Audio Transcriber MCP Server
Ichigo3766
A
security
A
license
A
quality
A MCP server that enables transcription of audio files using OpenAI's Speech-to-Text API, with support for multiple languages and file saving options.
Last updated -
1
4
7
JavaScript
MIT License
MCP Video Digest
R-lz
-
security
A
license
-
quality
A service that extracts and transcribes audio content from videos across 1000+ streaming websites including YouTube, Bilibili, TikTok, and Twitter, supporting multiple transcription providers like Deepgram, Gladia, Speechmatics, and AssemblyAI.
Last updated -
22
Python
MIT License

View all related MCP servers

MCP-Audio Plugin

MCP-Audio Plugin

Features

Setup (Local)

1. Clone and Install

2. Add .env file

3. Run the MCP server

4. Docker

4.1 Build and Run

API Overview

POST /api/v1/mcp/voice_model

POST /api/v1/mcp/tools.call (AIO Protocol)

GET /api/v1/mcp/help

Testing Tools

Base64 Voice Test

Health Check

MCP Registration (to AIO Endpoint Canister)

Related MCP Servers

MS-Lucidia-Voice-Gateway-MCP

Kokoro TTS MCP Server

Audio Transcriber MCP Server

MCP Video Digest

Appeared in Searches

New MCP Servers

MCP directory API