Advertise
MCP.so
Sign In

Kokoro Tts MCP Server

@mberg

Repository

Basic information

Category

Other

License

Apache-2.0

Transports

stdio

Author

mberg

About Kokoro Tts MCP Server

Kokoro Text to Speech (TTS) MCP Server

Kokoro Tts MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "kokoro-tts-mcp": {
      "command": "python",
      "args": [
        "mcp_client.py",
        "--text",
        "Hello, world!"
      ]
    }
  }
}

Kokoro Tts MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Kokoro Tts Mcp?

Kokoro Tts Mcp is a Model Context Protocol server that converts text to speech using the Kokoro TTS model. It generates .mp3 files that can be stored locally and optionally uploaded to Amazon S3. It is designed for developers who need programmatic TTS generation as part of an AI agent or automation pipeline.

How to use Kokoro Tts Mcp?

Clone the repository, download the Kokoro ONNX weights (kokoro-v1.0.onnx and voices-v1.0.bin), and install ffmpeg. Add the MCP configuration with required environment variables, then run uv run mcp-tts.py. Use the included client script mcp_client.py with --text or --file to send TTS requests.

Key features of Kokoro Tts Mcp

  • Generates .mp3 files from text input
  • Optional S3 upload for cloud storage
  • Configurable voice, speed, and language
  • Local MP3 retention and automatic cleanup
  • Supports text input from file or argument
  • Works with the Kokoro TTS model (ONNX)

Use cases of Kokoro Tts Mcp

  • Generate audio narration from text content
  • Automate voiceover creation for applications
  • Store TTS output in S3 for scalable access
  • Integrate TTS into AI agent conversations

Frequently asked questions

1

What dependencies are required to run the server?

Python with `uv`, ffmpeg (for .wav to .mp3 conversion), and the Kokoro ONNX model weights. The recommended install method is `uv run`.

2

How do I configure Amazon S3 uploads?

Set the environment variables `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`, `AWS_S3_BUCKET_NAME`, `AWS_S3_REGION`, and `AWS_S3_FOLDER`. Enable S3 with `S3_ENABLED=true`.

3

How can I change the voice used for TTS?

Set the `TTS_VOICE` environment variable (default `af_heart`) or use the `--voice` flag when calling `mcp_client.py`.

4

Where are generated MP3 files stored?

Locally in the folder specified by `MP3_FOLDER` (default is a `mp3` folder in the script directory). They can also be uploaded to S3 if `S3_ENABLED` is true.

5

Can I disable S3 upload without changing environment variables?

Yes. Pass the `--no-s3` flag to `mcp_client.py` to disable S3 upload for that request. You can also set `S3_ENABLED` to `false` in the environment.

Comments

More Other MCP servers

FastMCP v2 🚀

jlowin

🚀 The fast, Pythonic way to build MCP servers and clients.

26.0K

Yuppsy

Yuppsy MCP: build and publish real estate websites from your AI assistant. Yuppsy lets your AI assistant create live websites for real estate agents and individual property listings. You don't need a designer or any code

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K

YOUB

Connect your AI assistant to your own YOUB endurance training account. Read recorded activities with full analysis, planned sessions, race goals, wellness (HRV, sleep, resting HR) and your athletic profile. Create or mov

MCP Toolbox for Databases

googleapis

MCP Toolbox for Databases is an open source MCP server for databases.

15.9K
Advertise