minimax-tts-mcp

AIに発話能力を与える軽量なMCP（Model Context Protocol）サーバーです。テキストを入力すると、音声URLを返します。

Flask + MiniMax TTS API で構築されています。

機能

• MCPプロトコル経由で generate_speech ツールを公開します。

• AIがテキストを送信 → サーバーがMiniMax TTSを呼び出し → 再生可能なmp3 URLを返します。

• 感情制御、速度調整、言語選択（広東語、北京語など）に対応しています。

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"
    }
  }
}

このサーバーは1つのツールを公開します:

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、コンテナなど。公開する場合は、HTTPS付きのリバースプロキシ（nginx/caddy）の背後に配置してください。

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