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 設定に以下を追加してください。ご自身の値に更新してください。
ffmmegをインストールする
これは.wavファイルを.mp3ファイルに変換するために必要です
Macの場合:
ローカルで実行するには、これらを.envファイルに追加してください。env.exampleを参照し、.envにコピーして、ご自身の値に変更してください。
サポートされている環境変数
AWS_ACCESS_KEY_ID: AWSアクセスキーIDAWS_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互換ストレージのオプションのカスタムエンドポイントURLMCP_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を使用する
TTSクライアントの使用
mcp_client.pyスクリプトを使用すると、TTS リクエストをサーバーに送信できます。使い方は以下です。
接続設定
サーバーとクライアントを同じマシン上で実行する場合:
サーバーは
0.0.0.0(すべてのインターフェース) または127.0.0.1(ローカルホストのみ) にバインドする必要がありますクライアントは
localhostまたは127.0.0.1に接続する必要があります
基本的な使い方
ファイルからテキストを読み込む
音声と速度のカスタマイズ
S3アップロードを無効にする
コマンドラインオプション
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オプションを使用してリクエストごとに無効にすることができます。