OpenAI TTS MCP 서버

OpenAI의 Text-to-Speech API를 사용하여 텍스트를 음성으로 변환하는 MCP (Model Context Protocol) 서버입니다.

기능

• 텍스트 음성 변환: OpenAI TTS API를 사용하여 텍스트를 고품질 음성으로 변환
• 다양한 음성 옵션: 6가지 음성 (alloy, echo, fable, onyx, nova, shimmer) 지원
• 모델 선택: tts-1 (빠름) 또는 tts-1-hd (고품질) 모델 선택 가능
• 속도 조절: 0.25x ~ 4.0x 속도 조절 가능
• 다양한 형식: MP3, OPUS, AAC, FLAC 형식 지원
• 파일 관리: 생성된 오디오 파일 목록 조회 및 삭제 기능

설치 및 설정

1. 의존성 설치

npm install

2. OpenAI API 키 설정

환경변수로 OpenAI API 키를 설정해주세요:

export OPENAI_API_KEY="your-openai-api-key-here"

3. 서버 실행

npm start

개발 모드 (파일 변경 시 자동 재시작):

npm run dev

Claude Desktop에서 사용하기

Claude Desktop의 설정 파일에 다음과 같이 MCP 서버를 추가하세요:

macOS

~/Library/Application Support/Claude/claude_desktop_config.json

Windows

%APPDATA%\Claude\claude_desktop_config.json

Linux

~/.config/claude/claude_desktop_config.json

{
  "mcpServers": {
    "openai-tts": {
      "command": "node",
      "args": ["/home/ubuntu/daewook/openai-tts-mcp-server/src/index.js"],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key-here"
      }
    }
  }
}

사용 가능한 도구

1. text_to_speech

텍스트를 음성으로 변환합니다.

매개변수:

• text (필수): 음성으로 변환할 텍스트
• voice (선택): 음성 종류 (alloy, echo, fable, onyx, nova, shimmer)
• model (선택): TTS 모델 (tts-1, tts-1-hd)
• speed (선택): 음성 속도 (0.25 ~ 4.0)
• format (선택): 오디오 형식 (mp3, opus, aac, flac)

2. list_audio_files

생성된 오디오 파일 목록을 조회합니다.

3. delete_audio_file

지정된 오디오 파일을 삭제합니다.

매개변수:

• filename (필수): 삭제할 파일명

사용 예시

Claude에서 다음과 같이 사용할 수 있습니다:

안녕하세요를 음성으로 변환해주세요.

"Hello, this is a test message"를 nova 음성으로 1.2배 속도로 변환해주세요.

생성된 오디오 파일 목록을 보여주세요.

주의사항

• OpenAI API 키가 필요합니다
• 생성된 오디오 파일은 generated_audio 디렉토리에 저장됩니다
• API 사용량에 따라 요금이 부과될 수 있습니다

라이선스

MIT License