VOICEROID Daemon

Un servidor de texto a voz para VOICEROID2 a través de voiceroid_daemon.

GitHubPrueba este MCPPatrocinado

Documentación

voiceroid_daemon-mcp

Servidor MCP (Model Context Protocol) para síntesis de voz VOICEROID2 mediante voiceroid_daemon.

Características

  • Generación de síntesis de voz con voces VOICEROID2
  • Conversión fonética de texto a kana
  • Parámetros de voz personalizables (volumen, velocidad, tono, énfasis)
  • Reproducción de audio compatible con macOS, Windows y Linux
  • Soporte de autenticación básica

Requisitos previos

  • Node.js 18 o superior
  • voiceroid_daemon ejecutándose en tu sistema
  • VOICEROID2 instalado (para voiceroid_daemon)

Instalación

# Clone the repository
git clone https://github.com/mohemohe/voiceroid_daemon-mcp.git
cd voiceroid_daemon-mcp

# Install dependencies
npm install

Configuración

Crea un archivo .env en la raíz del proyecto (opcional):

# voiceroid_daemon server URL (default: http://127.0.0.1:8080)
VOICEROID_DAEMON_URL=http://127.0.0.1:8080

# Basic authentication (if required)
VOICEROID_DAEMON_USERNAME=your_username
VOICEROID_DAEMON_PASSWORD=your_password

# Default voice parameters (optional)
VOICEROID_DEFAULT_VOLUME=1.0        # 0-2
VOICEROID_DEFAULT_SPEED=1.3         # 0.5-4
VOICEROID_DEFAULT_PITCH=1.0         # 0.5-2
VOICEROID_DEFAULT_EMPHASIS=1.1      # 0-2
VOICEROID_DEFAULT_PAUSE_MIDDLE=150  # 80-500
VOICEROID_DEFAULT_PAUSE_LONG=370    # 100-2000
VOICEROID_DEFAULT_PAUSE_SENTENCE=800 # 0-10000

Uso

Ejecutar el servidor MCP

# Run directly with tsx (no build required)
npm start

# Or for development with auto-reload
npm run dev

Configurar con Claude Desktop

Añade lo siguiente a tu archivo de configuración de Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "voiceroid-daemon": {
      "command": "npx",
      "args": ["tsx", "/path/to/voiceroid_daemon-mcp/src/index.ts"],
      "env": {
        "VOICEROID_DAEMON_URL": "http://127.0.0.1:8080"
      }
    }
  }
}

Herramientas disponibles

test_connection

Prueba la conexión con el servidor voiceroid_daemon.

No parameters required

convert_text

Convierte texto japonés a lectura fonética en kana.

Parámetros:

  • text (cadena, obligatorio): Texto a convertir a kana

speak_text

Genera y reproduce audio de voz a partir de texto.

Parámetros:

  • text (cadena, obligatorio): Texto a pronunciar
  • kana (cadena, opcional): Lectura fonética en kana
  • volume (número, opcional): Volumen de voz (0-2, predeterminado: 1)
  • speed (número, opcional): Velocidad del habla (0.5-4, predeterminado: 1)
  • pitch (número, opcional): Tono de voz (0.5-2, predeterminado: 1)
  • emphasis (número, opcional): Nivel de énfasis (0-2, predeterminado: 1)

Ejemplo de uso en Claude

Una vez configurado, puedes usar las herramientas en Claude:

Use the test_connection tool to check if voiceroid_daemon is running.

Convert "こんにちは" to kana using the convert_text tool.

Use speak_text to say "こんにちは、今日はいい天気ですね" with speed 1.2.

Solución de problemas

Error de conexión

  1. Asegúrate de que voiceroid_daemon esté ejecutándose
  2. Verifica la URL en tu configuración
  3. Comprueba que la configuración del firewall permita conexiones
  4. Prueba con curl: curl http://127.0.0.1:8080/

Problemas de reproducción de audio

  • macOS: Usa afplay (integrado)
  • Windows: Usa Media.SoundPlayer de PowerShell
  • Linux: Requiere aplay (normalmente parte de alsa-utils)

Errores de autenticación

Si voiceroid_daemon requiere autenticación, asegúrate de haber configurado:

  • VOICEROID_DAEMON_USERNAME
  • VOICEROID_DAEMON_PASSWORD

Desarrollo

# Type checking
npm run typecheck

# Linting
npm run lint

# Run in development mode
npm run dev

Licencia

MIT