📢 Blabber-MCP 🗣️

¡Un servidor MCP que da voz a tus LLM usando la API de texto a voz de OpenAI! 🔊

✨ Características

Texto a voz: convierte el texto de entrada en audio hablado de alta calidad.
Selección de voz: elija entre varias voces OpenAI ( alloy , echo , fable , onyx , nova , shimmer ).
Selección del modelo: utilice modelos estándar ( tts-1 ) o de alta definición ( tts-1-hd ).
Opciones de formato: Obtenga salida de audio en mp3 , opus , aac o flac .
Guardar archivo: guarda el audio generado en un archivo local.
Reproducción opcional: reproduce automáticamente el audio generado mediante un comando de sistema configurable.
Valores predeterminados configurables: establezca una voz predeterminada a través de la configuración.

🔧 Configuración

Para utilizar este servidor, debe agregar su configuración al archivo de configuración de su cliente MCP (por ejemplo, mcp_settings.json ).

Obtener la clave API de OpenAI: necesita una clave API de OpenAI .
Agregar a la configuración de MCP: agregue el siguiente bloque al objeto mcpServers en su archivo de configuración, reemplazando "YOUR_OPENAI_API_KEY" con su clave real.

{
  "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": []
    }
  }
}

Importante: Asegúrate de que la ruta args apunte a la ubicación correcta del archivo build/index.js dentro del directorio del proyecto blabber-mcp . Usa la ruta absoluta completa.

🚀 Uso

Una vez configurada y en funcionamiento, puede utilizar la herramienta text_to_speech a través de su cliente MCP.

Herramienta: text_to_speech Servidor: blabber-mcp (o la clave que utilizó en la configuración)

Argumentos:

input (cadena, requerida ): El texto a sintetizar.
voice (cadena, opcional): La voz a usar ( alloy , echo , fable , onyx , nova , shimmer ). El valor predeterminado es DEFAULT_TTS_VOICE establecido en la configuración o nova .
model (cadena, opcional): El modelo ( tts-1 , tts-1-hd ). El valor predeterminado es tts-1 .
response_format (cadena, opcional): formato de audio ( mp3 , opus , aac , flac ). El valor predeterminado es mp3 .
play (booleano, opcional): Configúrelo como true para reproducir el audio automáticamente después de guardarlo. El valor predeterminado es false .

Ejemplo de llamada a herramienta (con reproducción):

<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>

Producción:

La herramienta guarda el archivo de audio en el directorio output/ dentro de la carpeta del proyecto blabber-mcp y devuelve una respuesta JSON como esta:

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

📜 Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

🕒 Registro de cambios

Consulte el archivo CHANGELOG.md para obtener detalles sobre el historial de versiones.