live-translate-mcp

live-translate-mcp

为 Claude 提供英语 ↔ 普通话实时语音翻译——由 Whisper、Claude AI 和 Piper TTS 驱动。

让 Claude 能够听、译、说。live-translate-mcp 是一个 Model Context Protocol（MCP） 服务，可在 Claude Desktop 和 Claude Code 中添加原生语音翻译工具。提供音频文件后，它会进行转录、翻译、语音合成并播放结果——所有操作均在本机完成，翻译由 Claude 处理。

---

功能介绍

步骤	技术	运行位置
语音 → 文本	OpenAI Whisper（通过 @huggingface/transformers）	本地
文本 → 翻译	Claude（Opus 4.8）	Anthropic API
翻译 → 语音	Piper TTS（ONNX）	本地

除了发送到 Claude API 的翻译文本外，音频不会离开你的设备。ASR 和 TTS 完全在设备本地运行。

---

工具

translate_file

翻译 WAV 音频文件。传入绝对路径后，服务会转录音频，通过 Claude 翻译文本，在原文件旁保存 <name>_translated.wav，并自动播放。

Translate /Users/alice/meeting_clip.wav

**返回：**原文、译文以及已保存输出文件的路径。

translate_speech

翻译以 base64 编码 WAV 字符串传入的原始音频。返回转录文本、译文和以 base64 WAV 格式表示的合成音频，适用于程序化工作流。

health_check

验证所有依赖项（Whisper 模型缓存、Piper 语音文件、espeak-ng）是否存在并已就绪，以便发起翻译请求。

---

安装

无需安装。使用 npx 直接运行：

npx -y live-translate-mcp

或者全局安装：

npm install -g live-translate-mcp

前置条件：

• Node.js 18+
• Anthropic API 密钥
• espeak-ng——用于 TTS 音素化（macOS 上运行 brew install espeak-ng，Linux 上运行 apt install espeak-ng）

Whisper 模型（约 150 MB）和 Piper 语音模型（约 200 MB）会在首次使用时自动下载，并缓存到 ~/.live-translate/。

---

Claude Desktop 配置

将以下内容添加到 Claude Desktop 配置文件中：

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"
      }
    }
  }
}

重启 Claude Desktop。你将在工具面板中看到 live-translate。

---

Claude Code 配置

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

然后，在启动 Claude Code 前设置环境变量中的 API 密钥，或通过 MCP env 配置传入。

---

使用示例

配置完成后，只需用自然语言向 Claude 提问：

“帮我翻译这个音频文件：/Users/alice/recording.wav”

“对 /tmp/interview.wav 使用 translate_file”

“检查 live-translate 是否已就绪”

Claude 会自动调用相应工具。

---

支持的语言

语言	ASR	翻译	TTS
英语	✓	✓	✓
中文普通话（普通话）	✓	✓	✓

系统会自动检测音频中的语言，无需指定。

---

对比

	live-translate-mcp	云端语音 API
ASR	本地（Whisper）	远程
翻译	Claude API	远程
TTS	本地（Piper）	远程
音频隐私	音频保留在设备上	音频会上传
费用	仅需支付 Claude API 费用	按分钟计费
离线使用	部分支持（ASR + TTS）	不支持

---

环境变量

变量	默认值	描述
ANTHROPIC_API_KEY	—	必需。 你的 Anthropic API 密钥。
PIPER_VOICE_DIR	~/.live-translate/voices	Piper .onnx 语音文件的路径。

---

相关项目

• live-translate — 独立的命令行工具，可通过按住说话进行翻译，无需 API 密钥，全程使用本地模型。
• Model Context Protocol — 此服务实现的开放标准。
• Piper TTS — 为语音合成提供支持的本地 TTS 引擎。

---

许可协议

MIT