📢 Blabber-MCP 🗣️

¡Un servidor MCP que le 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: Elige entre varias voces de OpenAI (alloy, echo, fable, onyx, nova, shimmer).

• Selección de modelo: Utiliza modelos estándar (tts-1) o de alta definición (tts-1-hd).

• Opciones de formato: Obtén salida de audio en mp3, opus, aac o flac.

• Guardado de archivos: Guarda el audio generado en un archivo local.

• Reproducción opcional: Reproduce automáticamente el audio generado usando un comando del sistema configurable.

• Valores predeterminados configurables: Establece una voz predeterminada a través de la configuración.

Related MCP server: NijiVoice-MCP

🔧 Configuración

Para usar este servidor, debes añadir su configuración al archivo de ajustes de tu cliente MCP (por ejemplo, mcp_settings.json).

1. Obtén tu clave de API de OpenAI: Necesitas una clave de API de OpenAI.

2. Añade a los ajustes de MCP: Añade el siguiente bloque al objeto mcpServers en tu archivo de ajustes, reemplazando "YOUR_OPENAI_API_KEY" con tu 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 de tu proyecto blabber-mcp. Usa la ruta absoluta completa.

🚀 Uso

Una vez configurado y en ejecución, puedes usar la herramienta text_to_speech a través de tu cliente MCP.

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

Argumentos:

• input (cadena, obligatorio): El texto a sintetizar.

• voice (cadena, opcional): La voz a utilizar (alloy, echo, fable, onyx, nova, shimmer). Por defecto usa DEFAULT_TTS_VOICE configurado en los ajustes, o nova.

• model (cadena, opcional): El modelo (tts-1, tts-1-hd). Por defecto es tts-1.

• response_format (cadena, opcional): Formato de audio (mp3, opus, aac, flac). Por defecto es mp3.

• play (booleano, opcional): Establece en true para reproducir automáticamente el audio después de guardarlo. Por defecto es false.

Ejemplo de llamada a la 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>

Salida:

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á bajo la Licencia MIT - consulta el archivo LICENSE para más detalles.

🕒 Registro de cambios

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