kokoro-tts-mcp-server

from ross-sec

Model Context Protocol (MCP) server for Kokoro text-to-speech with female voice. 100% local, no Python required. Supports SSE and stdio transports.

🔥🔥🔥✓ VerifiedFreeNeeds API keys

#email #automation #voice #git #maps

Ross Technologies Logo

MCP server for text-to-speech using Kokoro TTS

100% Local • No Python Required • Female Voice Default

📦 NPM Package | 🐙 GitHub Repository | 📚 Documentation

</div>

Overview

A production-ready MCP server that provides text-to-speech capabilities using the Kokoro TTS model. Features a default female voice (af_heart) and runs 100% locally using native JavaScript, eliminating Python dependencies.

Built by Ross Technologies
📍 Beer Sheva, Israel | 📧 devops.ross@gmail.com

Features

✅ 100% Local - No external API calls, complete privacy
✅ Native JavaScript - Built with TypeScript and Node.js
✅ SSE & Stdio Support - Multiple transport modes
✅ NPX Ready - Run directly without installation
✅ Female Voice Default - Uses af_heart voice out of the box
✅ Auto Audio Playback - Automatically saves and plays generated audio

Documentation

📚 Full Documentation Wiki

Quick Links:

Contributing

Contributions are welcome! See:

Contributing Guide
Development Guide

Links & Resources

📦 NPM Package - Install from npm
🐙 GitHub Repository - Source code and issues
📚 Documentation Wiki - Complete documentation
🐛 Report Issues - Bug reports and feature requests
💬 Discussions - Community discussions
🔗 Model Context Protocol - Learn about MCP
🔗 Kokoro TTS Model - Underlying TTS engine

License

MIT License - See LICENSE for details.

Made with ❤️ by Ross Technologies

</div>

Copy & paste — that's it

# Run with npx (no installation)
npx @ross_tchnologies/kokoro-tts-mcp-server

# Or install globally
npm install -g @ross_tchnologies/kokoro-tts-mcp-server
kokoro-tts-mcp

Quick Start

# Run with npx (no installation)
npx @ross_tchnologies/kokoro-tts-mcp-server

# Or install globally
npm install -g @ross_tchnologies/kokoro-tts-mcp-server
kokoro-tts-mcp

Installation

NPM

npm install @ross_tchnologies/kokoro-tts-mcp-server

NPX (No Installation)

npx @ross_tchnologies/kokoro-tts-mcp-server

Global Installation

npm install -g @ross_tchnologies/kokoro-tts-mcp-server

Visit Installation Guide for detailed instructions.

MCP Client Configuration

Add to your MCP configuration file (e.g., ~/.cursor/mcp.json):

{
  "mcpServers": {
    "kokoro-tts": {
      "command": "npx",
      "args": ["-y", "@ross_tchnologies/kokoro-tts-mcp-server"]
    }
  }
}

See Configuration Guide for more options.

Usage

Text to Speech Tool

{
  "name": "text_to_speech",
  "arguments": {
    "text": "Hello, world!",
    "voice": "af_heart",  // optional, default
    "speed": 1.0          // optional, default
  }
}

Available Voices: af_heart (default), af_bella, af_sarah, and more.

See API Reference for complete documentation.

Requirements

Node.js v18 or higher
No Python or other external dependencies required! 🎉