安裝

uv run mcp-tts.py

適合誰

如果你要把文字轉成 mp3，並可選再傳到 S3，這個服務對得上。官方把它寫成 Kokoro Text to Speech 的 MCP 伺服器，產生本機 mp3，並提供上傳到 S3 的選項。

適合已經能複製官方倉庫、會用 uv、並能下載 onnx 權重的人。官方要求把 kokoro-v1.0.onnx 與 voices-v1.0.bin 放到同一倉庫目錄。還需要 ffmpeg，以便把中間的 wav 轉成 mp3。mac 上官方給出的安裝是 brew install ffmpeg。

它不適合只想呼叫雲端介面、或不願在本機落音訊檔的人。產生本身會在磁碟寫入 mp3。也不適合第一次就把結果傳到 S3 的人：那會把音訊送出本機。

官方倉庫：

https://github.com/mberg/kokoro-tts-mcp

權重來源：

https://github.com/thewh1teagle/kokoro-onnx

官方推薦路徑只有一條：在已放好權重的本機倉庫裡，用 uv 執行 mcp-tts.py。不要另找安裝器，也不要第一次去配 S3。

uv run mcp-tts.py

前置條件：已把官方倉庫放到本機；已下載 kokoro-v1.0.onnx 與 voices-v1.0.bin 並與腳本同目錄；本機已有 ffmpeg。權重檔位址：

https://github.com/thewh1teagle/kokoro-onnx/releases/download/model-files-v1.0/kokoro-v1.0.onnx

https://github.com/thewh1teagle/kokoro-onnx/releases/download/model-files-v1.0/voices-v1.0.bin

設定位置：把上述 uv 命令寫進目前 MCP 用戶端的伺服器啟動項，工作目錄指向該倉庫。連上後做一次低風險呼叫：在用戶端列出的、屬於這個伺服器的工具裡，選產生本機 mp3 的項。官方沒有連續寫出函式名稱，不要編造函式名稱。合成會在本機寫檔，也會占用磁碟。

成功訊號：倉庫目錄裡出現新的 mp3，且沒有上傳到 S3。若啟動失敗，先核對兩個權重檔是否與 mcp-tts.py 在同一目錄，以及 ffmpeg 是否可用。

案例一：本機出音。對象是產生並本機儲存 mp3。用用戶端實際列出的合成工具，輸入一句不含隱私的短文字。證據沒有參數表和音色欄位名稱，成功以本機出現 mp3 為準。不要假設它會自動播放。

案例二：可選上傳 S3。官方寫明 mp3 存在本機，並可選擇上傳到 S3，也能設定這些檔案如何管理。這是寫出網。確認點是你已看過將上傳的音訊，並接受它會進入你的物件儲存之後，再行動。本頁沒有寫出金鑰變數名稱，不要編造。若用戶端沒有上傳項，到此為止。

沒有權重檔或 ffmpeg 時不要啟動。官方只寫了 mac 下的 brew install ffmpeg，不要改寫成其他系統的套件管理命令。uv 是推薦啟動方式，不要改成未出現的套件安裝器。

S3 上傳會出網並可能按官方說明在上傳後刪除或保留本機檔；未點名的儲存桶名稱、區域和憑證欄位不要補。合成不是零風險：文字會進入本機模型，音訊會落盤。官方沒有寫出撤銷或解除安裝路徑。