Kokoro TTS MCP Server

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Supports audio playback on Linux systems using the 'aplay' command for the generated speech audio files.

  • Supports audio playback on macOS using the 'afplay' command for the generated speech audio files.

Kokoro TTS MCP 服务器

一个模型上下文协议 (MCP) 服务器,使用 Kokoro TTS 引擎提供文本转语音功能。该服务器通过 MCP 工具提供 TTS 功能,让您可以轻松地将语音合成功能集成到您的应用程序中。

先决条件

  • Python 3.10 或更高版本
  • uv包管理器

安装

  1. 首先,安装uv包管理器:
curl -LsSf https://astral.sh/uv/install.sh | sh
  1. 克隆此存储库并安装依赖项:
uv venv source .venv/bin/activate # On Windows, use: .venv\Scripts\activate uv pip install .

特征

  • 具有可定制声音的文本转语音合成
  • 可调节语速
  • 支持将音频保存到文件或直接播放
  • 跨平台音频播放支持(Windows、macOS、Linux)

用法

服务器提供了一个单独的MCP工具generate_speech ,其参数如下:

  • text (必需):要转换为语音的文本
  • voice (可选):用于合成的语音(默认值:“af_heart”)
  • speed (可选):语速倍数(默认值:1.0)
  • save_path (可选):保存音频文件的目录
  • play_audio (可选):是否立即播放音频(默认值:False)

示例用法

from mcp.client import Client async with Client() as client: await client.connect("kokoro-tts") # Generate and play speech result = await client.call_tool( "generate_speech", { "text": "Hello, world!", "voice": "af_heart", "speed": 1.0, "play_audio": True } )

依赖项

  • kokoro >= 0.8.4
  • mcp[cli] >= 1.3.0
  • 声音文件 >= 0.13.1

平台支持

支持音频播放:

  • Windows(使用start
  • macOS(使用afplay
  • Linux(使用aplay

MCP 配置

将以下配置添加到您的 MCP 设置文件:

{ "mcpServers": { "kokoro-tts": { "command": "/Users/giannisan/pinokio/bin/miniconda/bin/uv", "args": [ "--directory", "/Users/giannisan/Documents/Cline/MCP/kokoro-tts-mcp", "run", "tts-mcp.py" ] } } }

执照

[在此添加您的许可证信息]

-
security - not tested
F
license - not found
-
quality - not tested

通过模型上下文协议提供文本转语音功能,使应用程序能够轻松地将语音合成与可定制的声音、可调节的语音速度和跨平台音频播放支持相结合。

  1. Prerequisites
    1. Installation
      1. Features
        1. Usage
          1. Example Usage
        2. Dependencies
          1. Platform Support
            1. MCP Configuration
              1. License
                ID: 83sig8ty3v