Kokoro テキスト読み上げ (TTS) MCP サーバー

S3 にアップロードするオプションを備えた .mp3 ファイルを生成する Kokoro Text to Speech MCP サーバー。

使用場所: https://huggingface.co/spaces/hexgrad/Kokoro-TTS

Related MCP server: Audio Transcriber MCP Server

構成

ローカルリポジトリにクローンします。
kokoro-v1.0.onnxとvoices-v1.0.binのKokoro Onnx Weightsをダウンロードし、同じリポジトリに保存します。

MCP 設定に以下を追加してください。ご自身の値に更新してください。

  "kokoro-tts-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/toyourlocal/kokoro-tts-mcp",
        "run",
        "mcp-tts.py"
      ],
      "env": {
        "TTS_VOICE": "af_heart",
        "TTS_SPEED": "1.0",
        "TTS_LANGUAGE": "en-us",
        "AWS_ACCESS_KEY_ID": "",
        "AWS_SECRET_ACCESS_KEY": "",
        "AWS_REGION": "us-east-1",
        "AWS_S3_FOLDER": "mp3",
        "S3_ENABLED": "true",
        "MP3_FOLDER": "/path/to/mp3"
      } 
    }

ffmmegをインストールする

これは.wavファイルを.mp3ファイルに変換するために必要です

Macの場合:

brew install ffmpeg

ローカルで実行するには、これらを.envファイルに追加してください。env.exampleを参照し、.envにコピーして、ご自身の値に変更してください。

サポートされている環境変数

AWS_ACCESS_KEY_ID : AWSアクセスキーID
AWS_SECRET_ACCESS_KEY : AWSシークレットアクセスキー
AWS_S3_BUCKET_NAME : S3バケット名
AWS_S3_REGION : S3リージョン（例：us-east-1）
AWS_S3_FOLDER : S3バケット内のフォルダパス
AWS_S3_ENDPOINT_URL : S3互換ストレージのオプションのカスタムエンドポイントURL
MCP_HOST : サーバーをバインドするホスト (デフォルト: 0.0.0.0)
MCP_PORT : リッスンするポート (デフォルト: 9876)
MCP_CLIENT_HOST : サーバーへのクライアント接続のホスト名 (デフォルト: localhost)
DEBUG : デバッグモードを有効にする（「true」または「1」に設定）
S3_ENABLED : S3アップロードを有効にする（「true」または「1」に設定）
MP3_FOLDER : MP3ファイルを保存するパス（デフォルトはスクリプトディレクトリ内の「mp3」フォルダ）
MP3_RETENTION_DAYS : MP3ファイルを自動的に削除するまで保存する日数
DELETE_LOCAL_AFTER_S3_UPLOAD : S3アップロードが成功した後にローカルのMP3ファイルを削除するかどうか（「true」または「1」に設定）
TTS_VOICE : TTSクライアントのデフォルトの音声（デフォルト: af_heart）
TTS_SPEED : TTSクライアントのデフォルト速度（デフォルト: 1.0）
TTS_LANGUAGE : TTSクライアントのデフォルト言語（デフォルト: en-us）

ローカルでサーバーを実行する

推奨される方法はUVを使用する

uv run mcp-tts.py

TTSクライアントの使用

mcp_client.pyスクリプトを使用すると、TTS リクエストをサーバーに送信できます。使い方は以下です。

接続設定

サーバーとクライアントを同じマシン上で実行する場合:

サーバーは0.0.0.0 (すべてのインターフェース) または127.0.0.1 (ローカルホストのみ) にバインドする必要があります
クライアントはlocalhostまたは127.0.0.1に接続する必要があります

基本的な使い方

python mcp_client.py --text "Hello, world!"

ファイルからテキストを読み込む

python mcp_client.py --file my_text.txt

音声と速度のカスタマイズ

python mcp_client.py --text "Hello, world!" --voice "en_female" --speed 1.2

S3アップロードを無効にする

python mcp_client.py --text "Hello, world!" --no-s3

コマンドラインオプション

python mcp_client.py --help

MP3ファイル管理

TTSサーバーはMP3ファイルを生成し、ローカルに保存するか、オプションでS3にアップロードします。これらのファイルの管理方法を設定できます。

ローカルストレージ

.envファイルでMP3_FOLDERを設定して、MP3ファイルが保存される場所を指定します。
ファイルは自動的に削除されない限りこのフォルダに保存されます

自動クリーンアップ

MP3_RETENTION_DAYS=30 （または任意の数字）を設定すると、その日数より古いファイルが自動的に削除されます。
DELETE_LOCAL_AFTER_S3_UPLOAD=trueを設定すると、S3 アップロードが成功した直後にローカルファイルを削除します。

S3統合

S3_ENABLED=trueまたはDISABLE_S3=trueで S3 アップロードを有効/無効にする
.envファイルで AWS 認証情報とバケット設定を構成する
S3アップロードはクライアントの--no-s3オプションを使用してリクエストごとに無効にすることができます。

Kokoro Text to Speech MCP Server