Kokoro Tts Mcp

Kokoro 文本转语音（TTS）MCP 服务

Kokoro 文本转语音 MCP 服务可生成 .mp3 文件，并可选择上传到 S3。

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

配置

• 克隆到本地仓库。
• 下载 Kokoro Onnx 权重，包括 kokoro-v1.0.onnx 和 voices-v1.0.bin，并将它们存放在同一仓库中。

将以下内容添加到 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：可选的自定义端点 URL，用于兼容 S3 的存储
• 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 凭证和存储桶设置
• 可使用客户端的 --no-s3 选项按请求禁用 S3 上传