Servidor MCP Kokoro TTS

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona capacidades de conversión de texto a voz mediante el motor TTS de Kokoro. Este servidor expone la funcionalidad TTS mediante herramientas MCP, lo que facilita la integración de la síntesis de voz en sus aplicaciones.

Prerrequisitos

Python 3.10 o superior
administrador de paquetes uv

Related MCP server: Typecast API MCP Server

Instalación

Primero, instale el administrador de paquetes uv :

curl -LsSf https://astral.sh/uv/install.sh | sh

Clonar este repositorio e instalar las dependencias:

uv venv
source .venv/bin/activate  # On Windows, use: .venv\Scripts\activate
uv pip install .

Características

Síntesis de texto a voz con voces personalizables
Velocidad de voz ajustable
Soporte para guardar audio en archivos o reproducción directa
Compatibilidad con reproducción de audio multiplataforma (Windows, macOS, Linux)

Uso

El servidor proporciona una única herramienta MCP generate_speech con los siguientes parámetros:

text (obligatorio): El texto que se convertirá a voz
voice (opcional): Voz que se utilizará para la síntesis (predeterminado: "af_heart")
speed (opcional): Multiplicador de velocidad del habla (predeterminado: 1.0)
save_path (opcional): Directorio para guardar archivos de audio
play_audio (opcional): si se debe reproducir el audio inmediatamente (predeterminado: Falso)

Ejemplo de uso

from mcp.client import Client

async with Client() as client:
    await client.connect("kokoro-tts")
    
    # Generate and play speech
    result = await client.call_tool(
        "generate_speech",
        {
            "text": "Hello, world!",
            "voice": "af_heart",
            "speed": 1.0,
            "play_audio": True
        }
    )

Dependencias

kokoro >= 0.8.4
mcp[cli] >= 1.3.0
archivo de sonido >= 0.13.1

Soporte de plataforma

La reproducción de audio es compatible con:

Windows (usando start )
macOS (usando afplay )
Linux (usando aplay )

Configuración de MCP

Agregue la siguiente configuración a su archivo de configuración de MCP:

{
  "mcpServers": {
    "kokoro-tts": {
      "command": "/Users/giannisan/pinokio/bin/miniconda/bin/uv",
      "args": [
        "--directory",
        "/Users/giannisan/Documents/Cline/MCP/kokoro-tts-mcp",
        "run",
        "tts-mcp.py"
      ]
    }
  }
}