Live Translate Mcp

io.github.jolucashornung由 GitHub 帳號 jolucashornung 發布v0.1.5更新於 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 音訊，回傳轉錄文字、譯文與合成音訊
  • 檢查 Whisper 模型快取、Piper 語音檔與 espeak-ng 等本機相依元件是否就緒
  • 在英文與華語之間自動辨識來源語言
適用情境
適合需要讓 Claude 對錄音（例如會議片段、訪談）進行英中語音翻譯，同時希望音訊本身留在本機的情況。適用於已持有 Anthropic API 金鑰的 Claude Desktop 或 Claude Code 桌面使用者。
執行需求
透過 npx 或全域 npm 安裝，以 stdio 在本機執行；需要 Node.js 18+、在 ANTHROPIC_API_KEY 提供 Anthropic API 金鑰，並安裝 espeak-ng 供 TTS 音素化使用。Whisper（約 150 MB）與 Piper 語音模型（約 200 MB）首次使用時下載至 ~/.live-translate/。僅限桌面端；可用 PIPER_VOICE_DIR 指定自訂語音檔。
安裝前請注意
需要 Anthropic API 金鑰，呼叫 Claude API 會產生費用。譯文文字會傳送至 Anthropic API，音訊本身留在本機。translate_file 會在來源檔旁寫入新的 WAV 並自動播放，會直接更動檔案並佔用喇叭。

安裝

在 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.5最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分