VOICEROID Daemon

voiceroid_daemon-mcp

Servidor MCP (Model Context Protocol) para conversão de texto em fala do VOICEROID2 via voiceroid_daemon.

Recursos

• Geração de conversão de texto em fala com vozes do VOICEROID2
• Conversão fonética de texto para kana
• Parâmetros de voz personalizáveis (volume, velocidade, tom, ênfase)
• Suporte à reprodução de áudio para macOS, Windows e Linux
• Suporte básico à autenticação

Pré-requisitos

• Node.js 18 ou superior
• voiceroid_daemon em execução no seu sistema
• VOICEROID2 instalado (para o voiceroid_daemon)

Instalação

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

# Install dependencies
npm install

Configuração

Crie um arquivo .env na raiz do projeto (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

Executando o Servidor MCP

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

# Or for development with auto-reload
npm run dev

Configurando com o Claude Desktop

Adicione o seguinte ao arquivo de configuração do 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"
      }
    }
  }
}

Ferramentas Disponíveis

test_connection

Testa a conexão com o servidor voiceroid_daemon.

No parameters required

convert_text

Converte texto japonês para leitura fonética em kana.

Parâmetros:

• text (string, obrigatório): Texto a ser convertido para kana

speak_text

Gera e reproduz áudio de fala a partir de texto.

Parâmetros:

• text (string, obrigatório): Texto a ser falado
• kana (string, opcional): Leitura fonética em kana
• volume (number, opcional): Volume da voz (0-2, padrão: 1)
• speed (number, opcional): Velocidade da fala (0.5-4, padrão: 1)
• pitch (number, opcional): Tom da voz (0.5-2, padrão: 1)
• emphasis (number, opcional): Nível de ênfase (0-2, padrão: 1)

Exemplo de Uso no Claude

Após a configuração, você pode usar as ferramentas no 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.

Solução de Problemas

Falha na Conexão

1. Certifique-se de que o voiceroid_daemon está em execução
2. Verifique a URL na sua configuração
3. Confirme se as configurações de firewall permitem conexões
4. Teste com curl: curl http://127.0.0.1:8080/

Problemas com Reprodução de Áudio

• macOS: Usa afplay (integrado)
• Windows: Usa o Media.SoundPlayer do PowerShell
• Linux: Requer aplay (geralmente parte do alsa-utils)

Erros de Autenticação

Se o voiceroid_daemon exigir autenticação, certifique-se de definir:

• VOICEROID_DAEMON_USERNAME
• VOICEROID_DAEMON_PASSWORD

Desenvolvimento

# Type checking
npm run typecheck

# Linting
npm run lint

# Run in development mode
npm run dev

Licença

MIT