MCP Audio Server
@samscarrow
About MCP Audio Server
No overview available yet
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"mcp-audio-server": {
"command": "docker",
"args": [
"compose",
"up",
"-d"
]
}
}
}Tools
No tools detected
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Overview
What is MCP Audio Server?
MCP Audio Server is a Model Context Protocol server for audio processing and chord analysis. It provides a RESTful API that decodes audio files, detects tempo and key, and performs chord recognition, making it suitable for developers integrating music analysis into MCP workflows.
How to use MCP Audio Server?
The quickest setup is via Docker Compose: clone the repository and run docker compose up -d. Alternatively, install manually with Python 3.10+, FFmpeg, and Poetry, then run poetry run uvicorn mcp_audio_server.main:app --host 0.0.0.0 --port 8000. Send a POST request to /analyze_chords with base64-encoded audio data and format (e.g., wav, mp3, ogg, m4a, flac) to receive chord, key, and tempo results.
Key features of MCP Audio Server
- Audio file decoding and normalization with FFmpeg
- Tempo detection (BPM)
- Key detection
- Chord analysis and tracking
- RESTful API with structured responses
- JSON schema validation for inputs and outputs
- Robust error handling with descriptive messages
- Resource management with concurrency controls
- Caching for performance optimization
- Observability with structured logging and metrics
Use cases of MCP Audio Server
- Automatically detect chords and key from recorded audio for music transcription.
- Analyze tempo and harmonic progression of WAV files for music production.
- Integrate real-time chord recognition into a live performance tool using MCP.
- Process batches of audio files to generate structured metadata for a music library.
FAQ from MCP Audio Server
What audio formats are supported?
Supported formats are wav, mp3, ogg, m4a, and flac.
What are the runtime dependencies?
Python 3.10 or higher, FFmpeg, and Poetry (for manual installation). Docker is fully supported.
How do I analyze chords using the API?
Send a POST request to /analyze_chords with JSON containing audio_data (base64-encoded), format (e.g., "wav"), and optional options.model ("basic" or "advanced").
Is there a health check endpoint?
Yes, endpoints /health, /ready, and /metrics are available for monitoring and load balancing.
How are errors reported?
Errors return a JSON object with error_code, message, details, and a correlation_id for debugging.
Frequently asked questions
What audio formats are supported?
Supported formats are wav, mp3, ogg, m4a, and flac.
What are the runtime dependencies?
Python 3.10 or higher, FFmpeg, and Poetry (for manual installation). Docker is fully supported.
How do I analyze chords using the API?
Send a POST request to `/analyze_chords` with JSON containing `audio_data` (base64-encoded), `format` (e.g., "wav"), and optional `options.model` ("basic" or "advanced").
Is there a health check endpoint?
Yes, endpoints `/health`, `/ready`, and `/metrics` are available for monitoring and load balancing.
How are errors reported?
Errors return a JSON object with `error_code`, `message`, `details`, and a `correlation_id` for debugging.
Basic information
More Media & Design MCP servers
RustChain MCP
ScottcjnMCP server for RustChain blockchain and BoTTube video platform — AI agent tools for earning RTC tokens. Built on createkr's RustChain SDK.
Framelink Figma MCP Server
GLipsMCP server to provide Figma layout information to AI coding agents like Cursor
MiniMax MCP JS
MiniMax-AIOfficial MiniMax Model Context Protocol (MCP) JavaScript implementation that provides seamless integration with MiniMax's powerful AI capabilities including image generation, video generation, text-to-speech, and voice cloning APIs.
yt-dlp-mcp
kevinwattA Model Context Protocol (MCP) server that bridges Video & Audio content with Large Language Models using yt-dlp.
Weather API MCP Server
TuanKiriA lightweight Model Context Protocol (MCP) server that enables AI assistants like Claude to retrieve and interpret real-time weather data. Discuss on Hacker News:
Comments