MCP Audio Inspector
Provides AI voice processing workflow integration for analyzing audio files generated by ElevenLabs
Uses FFmpeg/FFprobe as a fallback mechanism for analyzing exotic and corrupted audio formats that aren't supported by the primary metadata extraction library
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP Audio Inspector analyze the background music in my game's assets folder"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP Audio Inspector
A Model Context Protocol (MCP) server for comprehensive audio file analysis and metadata extraction, designed specifically for game audio development workflows.
Features
Comprehensive Metadata Extraction: Uses music-metadata library for detailed audio analysis
FFprobe Fallback: Handles exotic and corrupted formats through FFprobe
Game Audio Analysis: Specialized analysis for game development use cases
Batch Processing: Analyze entire directories of audio files
MCP Integration: Seamless integration with Claude Desktop
Cross-Platform: Works on Windows, macOS, and Linux
Related MCP server: Audio Analysis MCP Server
Installation
npm install -g mcp-audio-inspectorOr use with npx:
npx mcp-audio-inspectorUsage
MCP Server Mode (Claude Desktop)
Add to your Claude Desktop configuration:
{
"mcpServers": {
"audio-inspector": {
"command": "npx",
"args": ["-y", "mcp-audio-inspector"],
"env": {}
}
}
}Standalone CLI Mode
Analyze a single file:
npx mcp-audio-inspector --standalone path/to/audio.mp3Batch analyze a directory:
npx mcp-audio-inspector --batch path/to/audio/directorySave output to file:
npx mcp-audio-inspector --standalone audio.wav --output analysis.jsonSupported Formats
Primary Support (music-metadata):
MP3, WAV, FLAC, OGG, M4A, AAC, WMA, AIFF, AU, WebM, Opus, APE, MP4
Extended Support (FFprobe fallback):
Any format supported by FFmpeg
MCP Tools
analyze_audio_file
Analyze a single audio file and extract comprehensive metadata.
Parameters:
filePath(string, required): Path to the audio fileincludeGameAnalysis(boolean, optional): Include game-specific analysis (default: true)
analyze_audio_batch
Analyze all audio files in a directory.
Parameters:
directoryPath(string, required): Path to directory containing audio filesrecursive(boolean, optional): Search subdirectories recursively (default: false)includeGameAnalysis(boolean, optional): Include game-specific analysis (default: true)
get_supported_formats
Get list of supported audio formats.
Output Schema
The tool returns comprehensive metadata including:
{
"file": {
"path": "string",
"name": "string",
"size": "number",
"modified": "ISO date string"
},
"format": {
"container": "string",
"codec": "string",
"lossless": "boolean",
"duration": "number",
"bitrate": "number",
"sampleRate": "number",
"channels": "number",
"bitsPerSample": "number"
},
"tags": {
"title": "string",
"artist": "string",
"album": "string",
"year": "number",
"genre": "string",
"track": "number",
"comment": "string"
},
"gameAudio": {
"suitableForLoop": "boolean",
"recommendedCompressionFormat": "string",
"estimatedMemoryUsage": "number",
"platformOptimizations": {
"mobile": "string",
"desktop": "string",
"console": "string"
},
"compressionRatio": "number",
"gameDevNotes": "string"
}
}Game Audio Analysis
The inspector includes specialized analysis for game development:
Loop Suitability: Determines if audio is suitable for looping
Compression Recommendations: Suggests optimal compression formats
Memory Usage Estimation: Calculates uncompressed memory requirements
Platform Optimizations: Platform-specific optimization suggestions
Game Development Notes: Actionable recommendations for game audio
Requirements
Node.js 18+
FFmpeg/FFprobe (for fallback support)
Complete Documentation
This README provides a quick overview. For comprehensive documentation:
🚀 Getting Started
Installation Guide: Complete setup instructions
Quick Start Tutorial: Get running in 15 minutes
API Reference: Complete API documentation
🎮 Workflows & Tutorials
Game Audio Workflow: Complete game development pipeline
ElevenLabs Integration: AI voice processing workflow
Batch Processing Guide: Efficient mass audio processing
🔧 Support & Troubleshooting
Troubleshooting Guide: Common issues and solutions
Contributing Guide: How to contribute to the project
License
MIT License - see LICENSE file for details.
Contributing
Contributions welcome! Please read our Contributing Guide and submit pull requests to our GitHub repository.
Support
Issues: GitHub Issues
Documentation: README
Community: Discussions
Available Tools
3 toolsanalyze_audio_batchB
Analyze all audio files in a directory
Inputs: directoryPath (required), recursive, includeGameAnalysis.
analyze_audio_fileB
Analyze a single audio file and extract comprehensive metadata
Inputs: filePath (required), includeGameAnalysis.
get_supported_formatsB
Get list of supported audio formats
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a clearly distinct purpose: analyzing a batch of files, analyzing a single file, and listing supported formats. No overlap or ambiguity.
All tool names follow the consistent snake_case verb_noun pattern (analyze_audio_batch, analyze_audio_file, get_supported_formats).
Three tools is well-scoped for an audio inspection server, covering batch analysis, single file analysis, and format querying without excess or deficiency.
The tool set fully covers the domain of audio file inspection: analyzing individual files, batch processing, and checking supported formats. No obvious gaps.
Maintenance
Related MCP Connectors
Audio analysis and production jobs: BPM, key, fingerprint, tags, stems, cleanup, mastering.
Make all the audio for your game from a single prompt. Describe your game and your AI assistant plans every sound it needs (sound effects, ambience loops, music tracks and character voice lines), then generates them all in one go. You get several AI versions of each sound and keep the ones you like. Sounds are organized per game in folders and scenes, and the free Godot plugin installs them into your project, ready to play with one line of code. Works with Claude, Claude Code, Cursor and any MCP client, with OAuth login (no API key needed). Free plan included; sounds can be used in commercial games.
AI mixing and mastering: analyze your mixes, run DSP autofix, render stems, and master tracks.
AI-manageable audio CDN: upload, transcode, normalize, stream & deliver audio, plus grounded docs.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables batch audio processing and optimization using FFmpeg with preset configurations for game audio, voice processing, and music mastering, including specialized optimization for ElevenLabs AI voice output.93MIT
- FlicenseAqualityDmaintenanceEnables AI models to analyze audio files through numerical fingerprints, pitch tracking, and visual spectrograms without requiring direct audio playback. It provides tools for comparing audio iterations and detecting patterns using token-efficient analysis operations.14-
- AlicenseAqualityDmaintenanceEnables natural language control of Wwise audio middleware, allowing project auditing, batch editing, event creation, and reference checking through conversational interaction.201MIT
- FlicenseNot gradedqualityDmaintenanceAnalyzes audio files to extract exact, reproducible measurements like loudness, tempo, key, spectral balance, and clipping for LLM-based DAW control.-