Live Translate Mcp

dev.waxberry由 waxberry.dev 发布v0.1.6更新于 Oct 24, 2026

MCP server for local speech translation (EN ↔ 中文) via Whisper + Claude + Piper

已验证STDIO仅桌面媒体与设计AI 与机器学习

概览

AI 生成的概览

本地 MCP 服务器，让 Claude 借助 Whisper、Claude API 和 Piper TTS 转写、翻译并朗读英语与普通话音频。

可以做什么
翻译音频文件：转写 WAV 文件，经 Claude 翻译后合成语音，将译文 WAV 保存在原文件旁并自动播放，返回原文、译文和输出路径。翻译原始音频：接收 base64 编码的 WAV，返回转写文本、译文和 base64 合成音频。检查就绪状态：在翻译前确认 Whisper 模型缓存、Piper 语音文件和 espeak-ng 均已就绪。语言在英语与普通话之间自动识别。
适用场景
适合希望 Claude 在本机处理英汉语音翻译的场景：音频留在本地，仅译文发送至 Claude API。适用于会议片段、访谈或录音的转写、翻译与朗读。
运行要求
通过 npx 或全局 npm 安装在本机运行；需要 Node.js 18+、在 ANTHROPIC_API_KEY 中提供 Anthropic API 密钥，并安装 espeak-ng。Whisper 模型（约 150 MB）和 Piper 语音（约 200 MB）首次使用时下载并缓存于用户主目录；可用 PIPER_VOICE_DIR 更改语音路径。仅支持桌面端。
安装前请注意
需要 Anthropic API 密钥，这是会产生费用的凭据，翻译调用会产生 Claude API 费用。译文会发送至 Anthropic API，音频本身留在本机。服务器会在源文件旁写入译文 WAV 并自动播放音频。首次运行会下载数百 MB 的模型。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Live Translate Mcp，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

[Waxberry]

live-translate-mcp

[live-translate-mcp MCP server]

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.

[live-translate-mcp demo]

What it does

StepTechnologyWhere it runs
Speech → TextOpenAI Whisper (via @huggingface/transformers)Local
Text → TranslationClaude (Opus 4.8)Anthropic API
Translation → SpeechPiper 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:

bash
npx -y live-translate-mcp

Or install globally:

bash
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

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

bash
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

LanguageASRTranslationTTS
English✓✓✓
Mandarin Chinese (普通话)✓✓✓

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

How it compares

live-translate-mcpCloud speech APIs
ASRLocal (Whisper)Remote
TranslationClaude APIRemote
TTSLocal (Piper)Remote
Audio privacyAudio stays on deviceAudio uploaded
CostClaude API onlyPer-minute pricing
OfflinePartially (ASR + TTS)No

Environment variables

VariableDefaultDescription
ANTHROPIC_API_KEY—Required. Your Anthropic API key.
PIPER_VOICE_DIR~/.live-translate/voicesPath 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

来源：README.md，提交 8d4a4af

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.1.6最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分