Overview
Features
Kokoro TTS to MP3
Generates MP3 audio files from text using the Kokoro Text-to-Speech model.
Optional S3 Upload
Uploads MP3 files to S3 when enabled; per-request disable via the mcp_client.py client.
Environment-based Configuration
Configurable voice, speed, language and AWS/S3 settings via environment variables.
Local MP3 Management
Stores MP3s locally in a configurable MP3_FOLDER and supports automatic cleanup.
WAV to MP3 Conversion with FFmpeg
Requires FFmpeg to convert generated WAV audio to MP3 format.
UV-based Local Server
Run the MCP server locally using UV (uv run mcp-tts.py).
TTS Client Tool
Use mcp_client.py to send TTS requests with customizable text, voice, and speed.
S3 Endpoint Flexibility
Optionally configure a custom S3-compatible endpoint URL for storage.




