<p align="center"> <img src="assets/logo.png?v=2" alt="Waxberry" width="80" /> </p>

live-translate-mcp

Real-time English ↔ Mandarin speech translation for Claude — powered by Whisper, Claude AI, and Piper TTS.

Give Claude the ability to listen, translate, and speak. live-translate-mcp is a Model Context Protocol (MCP) server that adds speech translation as a native tool inside Claude Desktop and Claude Code. Hand it an audio file, and it transcribes, translates, synthesises, and plays the result — entirely on your machine, with Claude handling the translation.

<p align="center"> <img src="assets/demo.svg" alt="live-translate-mcp demo" width="860" /> </p>

---

What it does

| Step | Technology | Where it runs | |------|-----------|---------------| | Speech → Text | OpenAI Whisper (via @huggingface/transformers) | Local | | Text → Translation | Claude (Opus 4.8) | Anthropic API | | Translation → Speech | Piper TTS (ONNX) | Local |

Audio never leaves your machine except for the translated text sent to the Claude API. ASR and TTS run fully on-device.

---

Tools

translate_file

Translate a WAV audio file. Pass an absolute path — the server transcribes it, translates the text via Claude, synthesises speech, saves <name>_translated.wav next to the original, and plays it automatically.

Translate /Users/alice/meeting_clip.wav

Returns: original text, translation, and the path to the saved output file.

translate_speech

Translate raw audio passed as a base64-encoded WAV string. Returns the transcription, translation, and synthesised audio as base64 WAV — useful for programmatic workflows.

health_check

Verify that all dependencies (Whisper model cache, Piper voice files, espeak-ng) are present and ready before making a translation request.

---

Installation

No installation required. Run it directly with npx:

npx -y live-translate-mcp

Or install globally:

npm install -g live-translate-mcp

Prerequisites:

• Node.js 18+
• An Anthropic API key
• espeak-ng — for TTS phonemisation (brew install espeak-ng on macOS, apt install espeak-ng on Linux)

The Whisper model (~150 MB) and Piper voice models (~200 MB) download automatically on first use and are cached in ~/.live-translate/.

---

Claude Desktop setup

Add the following to your Claude Desktop configuration file:

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

{
  "mcpServers": {
    "live-translate": {
      "command": "npx",
      "args": ["-y", "live-translate-mcp"],
      "env": {
        "ANTHROPIC_API_KEY": "your-api-key-here"
      }
    }
  }
}

Restart Claude Desktop. You'll see live-translate appear in the tools panel.

---

Claude Code setup

claude mcp add live-translate -- npx -y live-translate-mcp

Then set your API key in the environment before starting Claude Code, or pass it via the MCP env config.

---

Usage examples

Once configured, just ask Claude naturally:

"Translate this audio file for me: /Users/alice/recording.wav"

"Use translate_file on /tmp/interview.wav"

"Check if live-translate is ready"

Claude will call the appropriate tool automatically.

---

Supported languages

| Language | ASR | Translation | TTS | |----------|-----|-------------|-----| | English | ✓ | ✓ | ✓ | | Mandarin Chinese (普通话) | ✓ | ✓ | ✓ |

Language is detected automatically from the audio — no need to specify it.

---

How it compares

| | live-translate-mcp | Cloud speech APIs | |--|--|--| | ASR | Local (Whisper) | Remote | | Translation | Claude API | Remote | | TTS | Local (Piper) | Remote | | Audio privacy | Audio stays on device | Audio uploaded | | Cost | Claude API only | Per-minute pricing | | Offline | Partially (ASR + TTS) | No |

---

Environment variables

| Variable | Default | Description | |----------|---------|-------------| | ANTHROPIC_API_KEY | — | Required. Your Anthropic API key. | | PIPER_VOICE_DIR | ~/.live-translate/voices | Path to Piper .onnx voice files. |

---

Related

• live-translate — the standalone CLI for push-to-talk translation with no API key required, using local models end-to-end.
• Model Context Protocol — the open standard this server implements.
• Piper TTS — the local TTS engine powering speech synthesis.

---

Licence

MIT