minimax-tts-mcp

Un servidor MCP (Model Context Protocol) ligero que da a la IA la capacidad de hablar. Texto dentro, URL de audio fuera.

Construido con Flask + MiniMax TTS API.

Qué hace

• Expone una herramienta generate_speech a través del protocolo MCP

• La IA envía texto → el servidor llama a MiniMax TTS → devuelve una URL de mp3 reproducible

• Soporta control de emociones, ajuste de velocidad y selección de idioma (cantonés, mandarín, etc.)

Related MCP server: Blabber-MCP

Inicio rápido

1. Clonar e instalar

git clone https://github.com/YOUR_USERNAME/minimax-tts-mcp.git
cd minimax-tts-mcp
pip install -r requirements.txt

2. Configurar

cp .env.example .env
# Edit .env with your MiniMax API key and voice ID

Obtén tu clave de API y tu ID de voz en MiniMax Platform.

3. Ejecutar

python server.py

El servidor se inicia en http://localhost:5000.

Endpoints

Integración MCP

Añade a la configuración de tu cliente MCP:

{
  "mcpServers": {
    "tts": {
      "url": "http://localhost:5000/mcp"
    }
  }
}

El servidor expone una herramienta:

generate_speech

Uso directo de TTS

curl -X POST http://localhost:5000/tts \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello world", "speed": 1.0}' \
  --output speech.mp3

Despliegue

Funciona en cualquier lugar donde se ejecute Python: un VPS, una máquina virtual en la nube o un contenedor. Para acceso público, colócalo detrás de un proxy inverso (nginx/caddy) con HTTPS.

Ejemplo con systemd:

# /etc/systemd/system/tts-mcp.service
[Unit]
Description=MiniMax TTS MCP Server

[Service]
WorkingDirectory=/path/to/minimax-tts-mcp
EnvironmentFile=/path/to/minimax-tts-mcp/.env
ExecStart=/usr/bin/python3 server.py
Restart=always

[Install]
WantedBy=multi-user.target

Notas

• Los archivos de audio generados se almacenan en /tmp y no se limpian automáticamente. Para producción, añade un trabajo cron o lógica de limpieza.

• La API de MiniMax es un servicio de pago. Consulta sus precios para el uso de TTS.

• La clonación de voz requiere configurar una voz personalizada en la plataforma MiniMax primero.

Licencia

MIT