MCP Audio Inspector

Analyzes audio files and extracts metadata, tailored for game audio development workflows.

A Model Context Protocol (MCP) server for comprehensive audio file analysis and metadata extraction, designed specifically for game audio development workflows.

- 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

Add to your Claude Desktop configuration:

{ "mcpServers": { "audio-inspector": { "command": "npx", "args": ["-y", "mcp-audio-inspector"], "env": {} } } }

npx mcp-audio-inspector --standalone path/to/audio.mp3

npx mcp-audio-inspector --batch path/to/audio/directory

npx mcp-audio-inspector --standalone audio.wav --output analysis.json

- MP3, WAV, FLAC, OGG, M4A, AAC, WMA, AIFF, AU, WebM, Opus, APE, MP4

Analyze a single audio file and extract comprehensive metadata.

- filePath(string, required): Path to the audio file
- includeGameAnalysis(boolean, optional): Include game-specific analysis (default: true)

- 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)

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" } }

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

- Node.js 18+
- FFmpeg/FFprobe (for fallback support)

This README provides a quick overview. For comprehensive documentation:

- Installation Guide: Complete setup instructions
- Quick Start Tutorial: Get running in 15 minutes
- API Reference: Complete API documentation

- Game Audio Workflow: Complete game development pipeline
- ElevenLabs Integration: AI voice processing workflow
- Batch Processing Guide: Efficient mass audio processing

- Troubleshooting Guide: Common issues and solutions
- Contributing Guide: How to contribute to the project

MIT License - seeLICENSEfile for details.

Contributions welcome! Please read ourContributing Guideand submit pull requests to our GitHub repository.

- Issues:GitHub Issues
- Documentation:README
- Community:Discussions

An MCP server for AI coding assistants to control, inspect, and modify Bevy applications using the Bevy Remote Protocol (BRP).