minimax-tts-mcp

AI가 말할 수 있게 해주는 경량 MCP(Model Context Protocol) 서버입니다. 텍스트를 입력하면 오디오 URL을 출력합니다.

Flask + MiniMax TTS API로 구축되었습니다.

기능

• MCP 프로토콜을 통해 generate_speech 도구를 노출합니다.

• AI가 텍스트를 보내면 → 서버가 MiniMax TTS를 호출 → 재생 가능한 mp3 URL을 반환합니다.

• 감정 조절, 속도 조절, 언어 선택(광둥어, 만다린 등)을 지원합니다.

Related MCP server: Blabber-MCP

빠른 시작

1. 클론 및 설치

git clone https://github.com/YOUR_USERNAME/minimax-tts-mcp.git
cd minimax-tts-mcp
pip install -r requirements.txt

2. 구성

cp .env.example .env
# Edit .env with your MiniMax API key and voice ID

MiniMax Platform에서 API 키와 음성 ID를 받으세요.

3. 실행

python server.py

서버는 http://localhost:5000에서 시작됩니다.

엔드포인트

MCP 통합

MCP 클라이언트 구성에 추가하세요:

{
  "mcpServers": {
    "tts": {
      "url": "http://localhost:5000/mcp"
    }
  }
}

서버는 하나의 도구를 노출합니다:

generate_speech

직접 TTS 사용

curl -X POST http://localhost:5000/tts \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello world", "speed": 1.0}' \
  --output speech.mp3

배포

Python이 실행되는 모든 환경에서 작동합니다 — VPS, 클라우드 VM, 컨테이너 등. 공개 액세스가 필요하면 HTTPS를 지원하는 리버스 프록시(nginx/caddy) 뒤에 배치하세요.

systemd 예시:

# /etc/systemd/system/tts-mcp.service
[Unit]
Description=MiniMax TTS MCP Server

[Service]
WorkingDirectory=/path/to/minimax-tts-mcp
EnvironmentFile=/path/to/minimax-tts-mcp/.env
ExecStart=/usr/bin/python3 server.py
Restart=always

[Install]
WantedBy=multi-user.target

참고 사항

• 생성된 오디오 파일은 /tmp에 저장되며 자동으로 정리되지 않습니다. 프로덕션 환경에서는 cron 작업이나 정리 로직을 추가하세요.

• MiniMax API는 유료 서비스입니다. TTS 사용 요금을 확인하세요.

• 음성 복제를 사용하려면 먼저 MiniMax 플랫폼에서 사용자 지정 음성을 설정해야 합니다.

라이선스

MIT