Skip to main content
MCP server CX Codex

live-translate-mcp — Claude Code MCP server: how to install

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

MIT ★ 3 updated 2026-06-17

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add live-translate-mcp -e ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> -- npx -y live-translate-mcp
Open on GitHub

What live-translate-mcp 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/.

What it helps with

  • 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 for the agent

  • 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

How to install live-translate-mcp

Platform CLI

claude mcp add live-translate-mcp -e ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> -- npx -y live-translate-mcp

Replace <…> with your own values

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about live-translate-mcp

How do I install live-translate-mcp in Claude Code?

Run claude mcp add live-translate-mcp -e ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> -- npx -y live-translate-mcp. Replace <ANTHROPIC_API_KEY> with your actual Anthropic key.

What does live-translate-mcp do?

It provides spoken translation between Mandarin and English. Transcription and voice synthesis run locally, while Claude translates the extracted text.

What external dependencies does the server need?

It requires Node.js 18+, a valid Anthropic API key, and espeak-ng on the host system. The first run fetches the required Whisper and Piper models automatically.

Similar MCP servers

All MCP servers for AI and ML →

Project sponsors

Companies that keep this analytics open