Install
uv run mcp-tts.py누구에게 맞나
텍스트를 mp3로 바꾸고 선택적으로 그다음 S3에 올리고 싶다면 이 서비스가 맞습니다. 공식은 Kokoro Text to Speech MCP 서버라고 쓰며 로컬 mp3를 만들고 S3 업로드 옵션을 제공합니다.
이미 공식 저장소를 클론할 수 있고 uv를 쓰며 onnx 가중치를 내려받을 수 있는 사람에게 맞습니다. 공식은 kokoro-v1.0.onnx와 voices-v1.0.bin을 같은 저장소 디렉터리에 두라고 요구합니다. 중간 wav를 mp3로 바꾸려면 ffmpeg도 필요합니다. Mac에서 공식이 주는 설치는 brew install ffmpeg입니다.
클라우드 인터페이스만 호출하고 싶거나 기기에 오디오 파일이 떨어지는 것을 원하지 않는 사람에게는 맞지 않습니다. 생성 자체가 디스크에 mp3를 씁니다. 처음에 결과를 S3로 보내고 싶은 사람에게도 맞지 않습니다. 그것은 오디오를 기기 밖으로 보냅니다.
공식 저장소:
https://github.com/mberg/kokoro-tts-mcp
가중치 출처:
https://github.com/thewh1teagle/kokoro-onnx
3분 만에 첫 시도를 끝내기
공식 권장 경로는 하나뿐입니다. 가중치를 이미 둔 로컬 저장소에서 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를 쓸 수 있는지 확인하세요.
사용 사례
사례 1: 기기에서 소리를 냅니다. 대상은 생성해 로컬 저장하는 mp3입니다. 클라이언트가 실제로 보여주는 합성 도구를 쓰고 프라이버시 없는 짧은 한 줄을 넣으세요. 증거에 매개변수 표와 음색 필드 이름은 없습니다. 성공은 로컬에 mp3가 나타나는 것입니다. 자동 재생한다고 가정하지 마세요.
사례 2: 선택적 S3 업로드. 공식은 mp3가 로컬에 있고 S3로 올릴 수 있으며 이들 파일을 어떻게 관리할지도 설정할 수 있다고 명시합니다. 그것은 외부 네트워크로 나갑니다. 확인점은 올릴 오디오를 이미 보았고 객체 저장소에 들어간다는 것을 받아들인 뒤에 움직이는 것입니다. 이 페이지는 키 변수 이름을 쓰지 않았습니다. 만들지 마세요. 클라이언트에 업로드 항목이 없으면 여기까지입니다.
사용 경계
가중치 파일이나 ffmpeg가 없으면 시작하지 마세요. 공식은 Mac의 brew install ffmpeg만 썼습니다. 다른 시스템의 패키지 관리 명령으로 바꾸지 마세요. uv가 권장 시작입니다. 나오지 않은 패키지 설치기로 바꾸지 마세요.
S3 업로드는 외부 네트워크로 나가며 공식 설명대로 업로드 후 로컬 파일을 지우거나 남길 수 있습니다. 이름이 나오지 않은 버킷 이름, 리전, 자격 증명 필드는 보태지 마세요. 합성은 무위험이 아닙니다. 텍스트는 기기 모델에 들어가고 오디오는 디스크에 떨어집니다. 공식은 실행 취소나 제거 경로를 쓰지 않았습니다.