convez.ai
MCP ServerIntegração & APIsIntermediário
falcoschaefer99-eng

MUSE TTS Embed

falcoschaefer99-eng/muse-tts-embed

Player de áudio local integrado ao Claude com 54 vozes e clonagem

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que adiciona um player de áudio persistente ao Claude com síntese de voz local. Oferece 54 vozes, clonagem de voz, controle de velocidade e download em WAV/MP3, tudo rodando na sua máquina sem APIs externas.

Instalação

$npx convez-ai falcoschaefer99-eng/muse-tts-embed

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
3
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 6 meses
Versão
—
Issues abertas
0
Contribuidores
3

Casos de uso

  • Gerar narração de textos longos com vozes personalizadas
  • Criar clones de voz para apresentações e conteúdo multimídia
  • Acessibilidade: converter respostas do Claude em áudio no chat

Veredito

Solução robusta de TTS local que integra bem ao Claude Desktop. O suporte a clonagem de voz e múltiplos engines (Kokoro, IndexTTS, Chatterbox) oferece flexibilidade real, mas exige dependências específicas por plataforma e configuração manual.

README

A tradução para o português deste README ainda está na fila.


What Is This?

MUSE TTS Embed gives Claude a persistent audio player — right in the chat. Everything runs on your machine.

Looking for direct audio playback without a player widget? See MUSE TTS Live.

Features

  • Embedded Player — play, pause, seek, replay
  • Voice Selector — switch between 54 voices without leaving the conversation
  • Voice Cloning — drop a WAV, get a clone (~7s)
  • Speed Control — 0.5x through 2.0x playback
  • Download — save any generation as WAV or MP3
  • 3 Engines — Kokoro-82M (~1s), IndexTTS-1.5 (Apple Silicon cloning), Chatterbox (cross-platform cloning)
  • Fully Local — no cloud APIs, no Docker, no subscription

Quick Start

1. Install dependencies

macOS (Apple Silicon — fastest):

pip install fastmcp mlx_audio

Windows / Linux / Intel Mac:

pip install fastmcp kokoro soundfile numpy

On Linux, you also need espeak-ng: sudo apt install espeak-ng

2. Add to Claude Desktop

Open Settings > Developer > Edit Config and add:

{
  "mcpServers": {
    "muse-tts-embed": {
      "command": "python3",
      "args": ["/path/to/muse-tts-embed/server.py"]
    }
  }
}

Restart Claude Desktop.

3. Speak

Ask Claude to speak anything. Try: "Say hello in a warm voice" or "Read this paragraph aloud"

Voice Cloning

Add your own reference WAV files to the voices/ directory. They'll be detected on startup.

voices/
  my_narrator.wav
  interview_voice.wav

Then ask Claude: "Speak this using the my_narrator clone"

Or use ref_audio to point to any WAV in voices/ or ~/Downloads/:

"Read this aloud using the reference audio at ~/Downloads/sample.wav"

Configuration

VariableDefaultDescription
KOKORO_VOICEam_onyxDefault voice ID
KOKORO_SPEED1.0Default speed (0.5 - 2.0)
MUSE_AUTH_TOKEN(required for HTTP)Bearer token for HTTP mode
MUSE_PORT3001HTTP server port
MUSE_HOST127.0.0.1HTTP bind address

HTTP Mode (Web / Mobile)

For Claude Web or Mobile, run the server in HTTP mode behind a tunnel:

export MUSE_AUTH_TOKEN=your-secret-token
python3 server.py --http

Then expose via tunnel (ngrok, cloudflared) and add the URL to Claude's MCP settings.

Browsers block auto-play. The player shows a "click to play" hint — tap play to start.

Voices

54 preset voices across 9 languages (American English, British English, Spanish, French, Hindi, Italian, Japanese, Portuguese, Mandarin).

LanguageFemaleMale
American Englishaf_alloy, af_aoede, af_bella, af_heart, af_jessica, af_kore, af_nicole, af_nova, af_river, af_sarah, af_skyam_adam, am_echo, am_eric, am_fenrir, am_liam, am_michael, am_onyx, am_puck, am_santa
British Englishbf_alice, bf_emma, bf_isabella, bf_lilybm_daniel, bm_fable, bm_george, bm_lewis
Spanishef_doraem_alex, em_santa
Frenchff_siwis--
Hindihf_alpha, hf_betahm_omega, hm_psi
Italianif_saraim_nicola
Japanesejf_alpha, jf_gongitsune, jf_nezumi, jf_tebukurojm_kumo
Portuguesepf_dorapm_alex, pm_santa
Mandarinzf_xiaobei, zf_xiaoni, zf_xiaoxiao, zf_xiaoyizm_yunjian, zm_yunxi, zm_yunxia, zm_yunyang

Tools

ToolWhat it does
muse_speak_embedSpeak text with embedded player (preset or cloned voice)
muse_embed_checkVerify engine, platform, and configuration

How It Works

Audio is delivered via structuredContent — bypasses model context, no size limit. The player is a self-contained HTML/JS app.

Requirements

  • Python 3.10+
  • Claude Desktop (latest version with MCP Apps support)
  • One of: mlx_audio (Mac M-series) or kokoro + soundfile (any platform)
  • ~200MB disk space (model downloads on first use)

Player shows "Generating..." but nothing happens: Check that the TTS engine is installed. Run muse_embed_check to verify status.

No sound on Web/Mobile: Browsers block auto-play. Click the play button.

"No TTS engine found": See installation above.

Model download is slow: First run downloads ~200MB.

"Text too long" error: Max 2000 characters per generation (~2 minutes of speech). Break longer text into parts.

Player doesn't appear: Update Claude Desktop to the latest version with MCP Apps support.

License

Licensed under the Apache License, Version 2.0.

Copyright 2026 The Funkatorium (Falco & Rook Schäfer). Protected under German Copyright Law (Urheberrechtsgesetz). Jurisdiction: Amtsgericht Berlin.


Ver o original no GitHub

Bom para

Relacionados