📢 Blabber-MCP 🗣️

OpenAI의 텍스트 음성 변환(TTS) API를 사용하여 LLM에 음성을 부여하는 MCP 서버입니다! 🔊

✨ 주요 기능

• 텍스트 음성 변환(TTS): 입력된 텍스트를 고품질 음성 오디오로 변환합니다.

• 음성 선택: 다양한 OpenAI 음성(alloy, echo, fable, onyx, nova, shimmer) 중에서 선택할 수 있습니다.

• 모델 선택: 표준(tts-1) 또는 고화질(tts-1-hd) 모델을 사용합니다.

• 형식 옵션: mp3, opus, aac, flac 형식으로 오디오를 출력합니다.

• 파일 저장: 생성된 오디오를 로컬 파일로 저장합니다.

• 선택적 재생: 구성 가능한 시스템 명령을 사용하여 생성된 오디오를 자동으로 재생합니다.

• 구성 가능한 기본값: 설정을 통해 기본 음성을 지정할 수 있습니다.

Related MCP server: NijiVoice-MCP

🔧 구성

이 서버를 사용하려면 MCP 클라이언트의 설정 파일(예: mcp_settings.json)에 구성을 추가해야 합니다.

1. OpenAI API 키 받기: OpenAI에서 API 키가 필요합니다.

2. MCP 설정에 추가: 설정 파일의 mcpServers 객체에 다음 블록을 추가하고, "YOUR_OPENAI_API_KEY"를 실제 키로 바꿉니다.

{
  "mcpServers": {
    "blabber-mcp": {
      "command": "node",
      "args": ["/full/path/to/blabber-mcp/build/index.js"], (IMPORTANT: Use the full, absolute path to the built index.js file)
      "env": {
        "OPENAI_API_KEY": "YOUR_OPENAI_API_KEY",
        "AUDIO_PLAYER_COMMAND": "xdg-open", (Optional: Command to play audio (e.g., "cvlc", "vlc", "mpv", "ffplay", "afplay", "xdg-open"; defaults to "cvlc")
        "DEFAULT_TTS_VOICE": "nova" (Optional: Set default voice (alloy, echo, fable, onyx, nova, shimmer); defaults to nova)
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

중요: args 경로가 blabber-mcp 프로젝트 디렉토리 내의 build/index.js 파일 위치를 정확히 가리키고 있는지 확인하세요. 전체 절대 경로를 사용하십시오.

🚀 사용법

구성이 완료되고 실행되면 MCP 클라이언트를 통해 text_to_speech 도구를 사용할 수 있습니다.

도구: text_to_speech 서버: blabber-mcp (또는 구성에서 사용한 키)

인자:

• input (문자열, 필수): 합성할 텍스트입니다.

• voice (문자열, 선택): 사용할 음성(alloy, echo, fable, onyx, nova, shimmer)입니다. 설정에 지정된 DEFAULT_TTS_VOICE 또는 nova가 기본값입니다.

• model (문자열, 선택): 모델(tts-1, tts-1-hd)입니다. 기본값은 tts-1입니다.

• response_format (문자열, 선택): 오디오 형식(mp3, opus, aac, flac)입니다. 기본값은 mp3입니다.

• play (불리언, 선택): 저장 후 오디오를 자동으로 재생하려면 true로 설정합니다. 기본값은 false입니다.

도구 호출 예시 (재생 포함):

<use_mcp_tool>
  <server_name>blabber-mcp</server_name>
  <tool_name>text_to_speech</tool_name>
  <arguments>
  {
    "input": "Hello from Blabber MCP!",
    "voice": "shimmer",
    "play": true
  }
  </arguments>
</use_mcp_tool>

출력:

이 도구는 오디오 파일을 blabber-mcp 프로젝트 폴더 내의 output/ 디렉토리에 저장하고 다음과 같은 JSON 응답을 반환합니다:

{
  "message": "Audio saved successfully. Playback initiated using command: cvlc",
  "filePath": "path/to/speech_1743908694848.mp3", 
  "format": "mp3",
  "voiceUsed": "shimmer"
}

📜 라이선스

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 LICENSE 파일을 참조하십시오.

🕒 변경 로그

버전 기록에 대한 자세한 내용은 CHANGELOG.md 파일을 참조하십시오.