Official description10 sourcesMCP servers8d ago
mberg/kokoro-tts-mcp
๐ ๐ - Text-to-speech with the open-weight Kokoro TTS models, saving MP3s locally or uploading them to an S3โฆ
View on GitHub โDirect link ยท no redirect page
Config template (adjust for your client)
claude mcp add kokoro-tts-mcp -- npx -y kokoro-tts-mcp
A pasteable skeleton generated from the repository name. Check the project README for the exact package and arguments.
- Star count
- 82 โ ยท mberg/kokoro-tts-mcp ยท read from the GitHub search API ยท (checked 2026-10-16 20:00:20)
- Source
- collected from the punkpeye/awesome-mcp-servers list ยท type: MCP server
- Harvest history
- first seen 2026-10-09 ยท last seen 2026-10-16 ยท seen 32ร ยท listed by 10 sources
- Score
- score 1,003 ยท 82 โ ยท 10 sources ยท mcp
FAQ (answers come from our records)
How do I install it?
We did not find an install command for this repository (our install coverage is only about 4%). Check its README or releases page.
Who is it for?
We filed it under these tags: MCP ๆๅก. The tags come from the entry itself, not a taxonomy we imposed.
Who maintains it?
repository
mberg/kokoro-tts-mcp๏ผfirst catalogued 2026-10-09๏ผlast seen 2026-10-16ใThere is no official certification or quality rating here โ we record sources and dates only.Third-party quality signals
Kokoro Text to Speech (TTS) MCP Server
ไปฅไธๆๅฝ่ช่ฏฅไปๅบ็ README๏ผ็ๆฎต๏ผ ยท ๅจ GitHub ่ฏปๅฎๆด README โ
Kokoro Text to Speech MCP server that generates .mp3 files with option to upload to S3.
Uses: https://huggingface.co/spaces/hexgrad/Kokoro-TTS
Configuration
* Clone to a local repo.
* Download the Kokoro Onnx Weights for kokoro-v1.0.onnx and voices-v1.0.bin and store in the same repo.
Add the following to your MCP configs. Update with your own values.
Install ffmmeg
This is needed to convert .wav to .mp3 files
For mac:
To run locally add these to your .env file. See env.example and copy to .env and modify with your own values.
Supported Environment Variables
- AWS_ACCESS_KEY_ID: Your AWS access key ID
- AWS_SECRET_ACCESS_KEY: Your AWS secret access key
- AWS_S3_BUCKET_NAME: S3 bucket name
- AWS_S3_REGION: S3 region (e.g., us-east-1)
- AWS_S3_FOLDER: Folder path within the S3 bucket
- AWS_S3_ENDPOINT_URL: Optional custom endpoint URL for S3-compatible storage
- MCP_HOST: Host to bind the server to (default: 0.0.0.0)
- MCP_PORT: Port to listen on (default: 9876)
- MCP_CLIENT_HOST: Hostname for client connections to the server (default: localhost)
- DEBUG: Enable debug mode (set to "true" or "1")
- S3_ENABLED: Enable S3 uploads (set to "true" or "1")
- MP3_FOLDER: Path to store MP3 files (default is 'mp3' folder in script directory)
- MP3_RETENTION_DAYS: Number of days to keep MP3 files before automatic deletion
- DELETE_LOCAL_AFTER_S3_UPLOAD: Whether to delete local MP3 files after successful S3 upload (set to "true" or "1")
- TTS_VOICE: Default voice for the TTS client (default: af_heart)
- TTS_SPEED: Default speed for the TTS client (default: 1.0)
- TTS_LANGUAGE: Default language for the TTS client (default: en-us)
Running the Server Locally
Preferred method use UV
Using the TTS Client
The mcp_client.py script allows you to send TTS requests to the server. It can be used as follows:
Connection Settings
When running the server and client on the same machine:
- Server should bind to 0.0.0.0 (all interfaces) or 127.0.0.1 (localhost only)
- Client should connect to localhost or 127.0.0.1
Basic Usage
Reading Text from a File
Customizing Voice and Speed
Disabling S3 Upload
Command-line Options
MP3 File Management
The TTS server generates MP3 files that are stored locally and optionally uploaded to S3. You can configure how these files are managed:
Local Storage
- Set MP3_FOLDER in your .env file to specify where MP3 files are stored
Uses: https://huggingface.co/spaces/hexgrad/Kokoro-TTS
Configuration
* Clone to a local repo.
* Download the Kokoro Onnx Weights for kokoro-v1.0.onnx and voices-v1.0.bin and store in the same repo.
Add the following to your MCP configs. Update with your own values.
Install ffmmeg
This is needed to convert .wav to .mp3 files
For mac:
To run locally add these to your .env file. See env.example and copy to .env and modify with your own values.
Supported Environment Variables
- AWS_ACCESS_KEY_ID: Your AWS access key ID
- AWS_SECRET_ACCESS_KEY: Your AWS secret access key
- AWS_S3_BUCKET_NAME: S3 bucket name
- AWS_S3_REGION: S3 region (e.g., us-east-1)
- AWS_S3_FOLDER: Folder path within the S3 bucket
- AWS_S3_ENDPOINT_URL: Optional custom endpoint URL for S3-compatible storage
- MCP_HOST: Host to bind the server to (default: 0.0.0.0)
- MCP_PORT: Port to listen on (default: 9876)
- MCP_CLIENT_HOST: Hostname for client connections to the server (default: localhost)
- DEBUG: Enable debug mode (set to "true" or "1")
- S3_ENABLED: Enable S3 uploads (set to "true" or "1")
- MP3_FOLDER: Path to store MP3 files (default is 'mp3' folder in script directory)
- MP3_RETENTION_DAYS: Number of days to keep MP3 files before automatic deletion
- DELETE_LOCAL_AFTER_S3_UPLOAD: Whether to delete local MP3 files after successful S3 upload (set to "true" or "1")
- TTS_VOICE: Default voice for the TTS client (default: af_heart)
- TTS_SPEED: Default speed for the TTS client (default: 1.0)
- TTS_LANGUAGE: Default language for the TTS client (default: en-us)
Running the Server Locally
Preferred method use UV
Using the TTS Client
The mcp_client.py script allows you to send TTS requests to the server. It can be used as follows:
Connection Settings
When running the server and client on the same machine:
- Server should bind to 0.0.0.0 (all interfaces) or 127.0.0.1 (localhost only)
- Client should connect to localhost or 127.0.0.1
Basic Usage
Reading Text from a File
Customizing Voice and Speed
Disabling S3 Upload
Command-line Options
MP3 File Management
The TTS server generates MP3 files that are stored locally and optionally uploaded to S3. You can configure how these files are managed:
Local Storage
- Set MP3_FOLDER in your .env file to specify where MP3 files are stored
- Source
- awesome ยท https://github.com/mberg/kokoro-tts-mcp
- Browse by field
- MCP servers
- Traction
- 82 โ
- added
- yesterday
More in MCP servers
Filed under
Every tag opens the full list for that filter. Counts are the live catalogue figures.