코코로 TTS MCP 서버

Kokoro TTS 엔진을 사용하여 텍스트-음성 변환 기능을 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 MCP 도구를 통해 TTS 기능을 제공하므로, 음성 합성 기능을 애플리케이션에 쉽게 통합할 수 있습니다.

필수 조건

• Python 3.10 이상

• uv 패키지 관리자

Related MCP server: Typecast API MCP Server

설치

1. 먼저, uv 패키지 관리자를 설치하세요.

지엑스피1

2. 이 저장소를 복제하고 종속성을 설치하세요.

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
        }
    )

종속성

• 코코로 >= 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"
      ]
    }
  }
}

특허

[여기에 라이센스 정보를 추가하세요]