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
claude mcp add live-translate-mcp -e ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> -- npx -y live-translate-mcpWhat 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.wavand 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-mcpReplace <…> with your own values
Platform CLI
codex mcp add live-translate-mcp --env ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> -- npx -y live-translate-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"live-translate-mcp": {
"command": "npx",
"args": [
"-y",
"live-translate-mcp"
],
"env": {
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"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
Platform CLI
gemini mcp add -e ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> live-translate-mcp npx -y live-translate-mcpReplace <…> 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.