MCP Audio Tweaker

A Model Context Protocol (MCP) server for batch audio processing and optimization using FFmpeg. This package provides parameter-based audio modifications including sample rate conversion, bitrate adjustment, volume control, channel configuration, and audio effects.

- 🎵Comprehensive Audio Processing: Sample rate conversion, bitrate adjustment, volume control, channel configuration
- 🔧FFmpeg Integration: Leverages FFmpeg for robust, cross-platform audio processing
- 📦Batch Processing: Process multiple audio files concurrently with queue management
- 🎯Preset System: Predefined configurations for common use cases (game audio, voice processing, music mastering)
- 🎮Game Audio Optimized: Special presets for mobile, desktop, and console game development
- 🤖ElevenLabs Integration: Optimized preset for ElevenLabs AI voice output
- 🔍MCP Compatible: Full integration with Claude Desktop and other MCP clients
- ⚡Concurrent Processing: Efficient queue-based processing for large batch operations
- 📊Detailed Reporting: Comprehensive processing results and error handling

- Node.js 18.0.0 or higher
- FFmpeg installed and available in system PATH

# Using Chocolatey choco install ffmpeg # Using winget winget install FFmpeg

# Ubuntu/Debian sudo apt update && sudo apt install ffmpeg # CentOS/RHEL sudo yum install ffmpeg

Add to your Claude Desktop configuration:

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

mcp-audio-tweaker --standalone process \ --input input.wav \ --output output.mp3 \ --volume -3 \ --sample-rate 44100 \ --bitrate 192 \ --normalize

mcp-audio-tweaker --standalone batch \ --input-dir ./audio/raw \ --output-dir ./audio/processed \ --preset game-audio-mobile

Process a single audio file with custom operations.

- inputFile(string): Path to input audio file
- outputFile(string): Path for output file
- operations(object): Audio processing operations
- overwrite(boolean): Whether to overwrite existing files

{ "inputFile": "/path/to/input.wav", "outputFile": "/path/to/output.mp3", "operations": { "volume": { "adjust": -3, "normalize": true, "targetLUFS": -20 }, "format": { "sampleRate": 44100, "bitrate": 192, "channels": 2, "codec": "mp3" }, "effects": { "fadeIn": 0.1, "fadeOut": 0.2 } } }

Process multiple audio files in a directory.

- inputDirectory(string): Directory containing input files
- outputDirectory(string): Directory for processed files
- filePattern(string): Glob pattern for file matching
- operations(object): Audio processing operations
- overwrite(boolean): Whether to overwrite existing files

Apply predefined audio processing preset.

- inputFile(string): Path to input audio file
- outputFile(string): Path for output file
- preset(string): Preset name to apply
- overwrite(boolean): Whether to overwrite existing files

- game-audio-mobile: Optimized for mobile games
- game-audio-desktop: High-quality for desktop games
- game-audio-console: Premium quality for consoles
- elevenLabs-optimize: Optimizes ElevenLabs AI voice output
- voice-processing: General voice and dialogue processing
- music-mastering: High-quality music mastering
- sfx-optimization: Sound effects and ambient audio

List all available presets with descriptions.

- category(string, optional): Filter by category (game,voice,music,effects)

Get current status of the audio processing queue.

{ "volume": { "adjust": -3, // Volume adjustment in dB (-60 to +20) "normalize": true, // Apply loudness normalization "targetLUFS": -23 // Target LUFS for normalization } }

{ "format": { "sampleRate": 44100, // Sample rate (8000, 16000, 22050, 44100, 48000, 96000, 192000) "bitrate": 192, // Bitrate in kbps (64-320) "channels": 2, // Channel count (1, 2, 6, 8) "codec": "mp3" // Codec (pcm, mp3, aac, vorbis, flac) } }

{ "effects": { "fadeIn": 0.1, // Fade in duration in seconds "fadeOut": 0.2, // Fade out duration in seconds "trim": { // Trim audio "start": 1.0, // Start time in seconds "end": 30.0 // End time in seconds }, "loop": { // Loop audio "enabled": true, "count": 3 // Number of loops } } }

@audio-tweaker Apply the elevenLabs-optimize preset to the file /audio/voice-output.wav and save it as /audio/optimized-voice.mp3

@audio-tweaker Process all WAV files in /game-assets/audio/raw/ using the game-audio-mobile preset and save them to /game-assets/audio/mobile/

@audio-tweaker Process /recordings/dialogue.wav with the following operations: normalize audio to -20 LUFS, convert to 22kHz mono MP3 at 128kbps, add 0.05s fade in and 0.1s fade out, and save as /processed/dialogue.mp3

@audio-tweaker What's the current status of the audio processing queue?

- Generate AI Voice with ElevenLabs
- Optimize with MCP Audio Tweaker: ApplyelevenLabs-optimizepreset
- Platform-specific Processing: Usegame-audio-mobile,game-audio-desktop, orgame-audio-consolepresets
- Integration: Import optimized audio into game engine
- Record/Import Audio
- Master with Audio Tweaker: Applymusic-masteringpreset
- Platform Optimization: Create platform-specific versions
- Distribution: Export in required formats

- AUDIO_TWEAKER_LOG_LEVEL: Set logging level (debug,info,warn,error)
- FFMPEG_PATH: Custom FFmpeg binary path (optional)

The package supports advanced FFmpeg configurations through direct parameter passing. See the FFmpeg documentation for additional options.

The package provides comprehensive error handling with specific error codes:

- FILE_NOT_FOUND: Input file does not exist
- FFMPEG_NOT_FOUND: FFmpeg not installed or not in PATH
- INVALID_PARAMETERS: Processing parameters validation failed
- OUTPUT_WRITE_FAILED: Cannot write to output location
- PROCESSING_FAILED: FFmpeg processing failed
- PRESET_NOT_FOUND: Requested preset does not exist

- Concurrent Processing: Default 2 concurrent operations (configurable)
- Queue Management: Efficient processing queue with pause/resume capabilities
- Memory Efficient: Streams audio data without loading entire files into memory
- Cross-platform: Optimized for Windows, macOS, and Linux

Input Formats:MP3, WAV, OGG, FLAC, M4A, AACOutput Formats:MP3, WAV, OGG, FLAC, M4A, AAC

git clone https://github.com/your-org/mcp-audio-tweaker.git cd mcp-audio-tweaker npm install npm run build

npm test npm run test:coverage npm run test:ffmpeg

- Fork the repository
- Create a feature branch
- Make your changes
- Add tests for new functionality
- Submit a pull request

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

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

MIT License - seeLICENSEfile for details.

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

- Built withFFmpegfor audio processing
- UsesModel Context Protocolfor Claude Desktop integration
- Designed forInfinity Cubegame audio workflow

AI podcast editing as a service. Upload raw audio or submit a URL, get back edited episodes with filler words removed, noise reduction, transcripts, show notes, and social clips. Includes webhooks for automation.