코코로 TTS MCP 서버

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

필수 조건

Python 3.10 이상
uv 패키지 관리자

Related MCP server: Typecast API MCP Server

설치

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

지엑스피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 } )

종속성

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