live-translate-mcp

live-translate-mcp

Whisper、Claude AI、Piper TTS を活用した、Claude 向けの英語 ↔ 中国語のリアルタイム音声翻訳です。

Claude が音声を聞き取り、翻訳し、話せるようになります。live-translate-mcp は、Claude Desktop と Claude Code でネイティブツールとして音声翻訳を追加する Model Context Protocol (MCP) サーバーです。音声ファイルを渡すと、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 キー不要で、ローカルモデルをエンドツーエンドで使用する、プッシュ・トゥ・トーク翻訳用のスタンドアロン CLI です。
• Model Context Protocol — このサーバーが実装するオープン標準です。
• Piper TTS — 音声合成を支えるローカル TTS エンジンです。

---

ライセンス

MIT