# live-translate-mcp

live-translate-mcp runs on-device speech translation between English and Mandarin Chinese. It transcribes audio, translates text with Claude, and synthesizes output speech.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 3 repo stars
- Author: waxberry-dev
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/waxberry-dev/live-translate-mcp
- Updated: 2026-06-17
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/live-translate-mcp

## What it does

This server connects local speech processing with cloud language models. Local Whisper transcribes speech to text, while Piper TTS handles speech output on your machine. Text translation between English and Mandarin routes through the Claude API. Audio files never leave your system.

Two tools handle audio processing: `translate_file` accepts a direct path to a WAV file and saves a `_translated.wav` track alongside it. For automated pipelines, `translate_speech` accepts and returns base64 payloads. Language detection between English and Mandarin happens automatically.

Running the server requires Node.js 18+ and an `ANTHROPIC_API_KEY`. You also need `espeak-ng` installed on your system. Speech synthesis will fail immediately without it. On the first run, the server downloads a 150 MB Whisper model and 200 MB voice data into `~/.live-translate/`.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `ANTHROPIC_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add live-translate-mcp -e ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> -- npx -y live-translate-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add live-translate-mcp --env ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> -- npx -y live-translate-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "live-translate-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "live-translate-mcp"
            ],
            "env": {
                "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "live-translate-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "live-translate-mcp"
            ],
            "env": {
                "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> live-translate-mcp npx -y live-translate-mcp
```
Replace <…> with your own values

## When to use it
- translate spoken English or Mandarin into the other language
- keep audio recordings strictly on the local machine during translation
- generate translated WAV files directly from file paths
- verify speech runtime dependencies before running transcription jobs

## Example prompts
- Translate this audio file for me: `/Users/alice/recording.wav`
- Run health_check to verify local speech dependencies
- Use translate_file on `/tmp/interview.wav` and play the audio

## Similar
- [document-to-narration](https://affpapa.org/en/nevibecode/skills/document-to-narration.md) — skill · 1000 installs
- [eachlabs-voice-audio](https://affpapa.org/en/nevibecode/skills/eachlabs-voice-audio.md) — skill · 336 installs
- [hyperframes-media](https://affpapa.org/en/nevibecode/skills/boraoztunc-hyperframes-media.md) — skill · 218 installs
- [translate-book](https://affpapa.org/en/nevibecode/skills/translate-book.md) — skill · 2100 installs
- [video-translate](https://affpapa.org/en/nevibecode/skills/video-translate.md) — skill · 1200 installs
- [translate](https://affpapa.org/en/nevibecode/skills/feiskyer-translate.md) — skill · 294 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
