minimax-tts-mcp

Ein leichtgewichtiger MCP-Server (Model Context Protocol), der KI die Fähigkeit zum Sprechen verleiht. Text rein, Audio-URL raus.

Erstellt mit Flask + MiniMax TTS API.

Was es tut

• Stellt ein generate_speech-Tool über das MCP-Protokoll bereit

• KI sendet Text → Server ruft MiniMax TTS auf → gibt eine abspielbare MP3-URL zurück

• Unterstützt Emotionssteuerung, Geschwindigkeitsanpassung und Sprachauswahl (Kantonesisch, Mandarin usw.)

Related MCP server: Blabber-MCP

Schnellstart

1. Klonen und installieren

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

2. Konfigurieren

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

Holen Sie sich Ihren API-Schlüssel und Ihre Voice-ID von der MiniMax Platform.

3. Ausführen

python server.py

Der Server startet unter http://localhost:5000.

Endpunkte

MCP-Integration

Fügen Sie Folgendes zu Ihrer MCP-Client-Konfiguration hinzu:

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

Der Server stellt ein Tool bereit:

generate_speech

Direkte TTS-Nutzung

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

Bereitstellung

Funktioniert überall, wo Python läuft – einem VPS, einer Cloud-VM oder einem Container. Für den öffentlichen Zugriff setzen Sie es hinter einen Reverse-Proxy (nginx/caddy) mit HTTPS.

Beispiel mit 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

Hinweise

• Generierte Audiodateien werden in /tmp gespeichert und nicht automatisch bereinigt. Für die Produktion fügen Sie einen Cron-Job oder eine Bereinigungslogik hinzu.

• Die MiniMax-API ist ein kostenpflichtiger Dienst. Überprüfen Sie deren Preise für die TTS-Nutzung.

• Für die Stimmklonung müssen Sie zuerst eine benutzerdefinierte Stimme auf der MiniMax-Plattform einrichten.

Lizenz

MIT