minimax-tts-mcp

Легковесный MCP-сервер (Model Context Protocol), который даёт ИИ возможность говорить. Текст на вход — URL аудио на выход.

Создан с помощью Flask + MiniMax TTS API.

Что он делает

• Предоставляет инструмент generate_speech через протокол MCP

• ИИ отправляет текст → сервер вызывает MiniMax TTS → возвращает воспроизводимый URL mp3

• Поддерживает управление эмоциями, регулировку скорости и выбор языка (кантонский, мандарин и т. д.)

Related MCP server: Blabber-MCP

Быстрый старт

1. Клонирование и установка

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

2. Настройка

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

Получите свой API-ключ и ID голоса на MiniMax Platform.

3. Запуск

python server.py

Сервер запускается на http://localhost:5000.

Эндпоинты

Интеграция с MCP

Добавьте в конфигурацию вашего MCP-клиента:

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

Сервер предоставляет один инструмент:

generate_speech

Прямое использование TTS

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

Развёртывание

Работает везде, где есть Python — VPS, облачная VM или контейнер. Для публичного доступа разместите за обратным прокси (nginx/caddy) с HTTPS.

Пример с 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

Примечания

• Сгенерированные аудиофайлы хранятся в /tmp и не очищаются автоматически. Для продакшена добавьте cron-задачу или логику очистки.

• MiniMax API — платный сервис. Ознакомьтесь с их тарифами на использование TTS.

• Клонирование голоса требует настройки пользовательского голоса на платформе MiniMax.

Лицензия

MIT