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

Installation

Or use with npx:

Usage

MCP Server Mode (Claude Desktop)

Add to your Claude Desktop configuration:

Standalone CLI Mode

Analyze a single file:

Batch analyze a directory:

Save output to file:

Supported 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 file

• includeGameAnalysis (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 files

• recursive (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:

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