Fast Whisper MCP Server

🚀 Faster Whisperベースの高性能音声認識MCPサーバ

このサーバはFaster Whisperをベースに構築された高性能な音声認識MCPサーバで、強力な音声文字起こし機能を提供します。

🚀 クイックスタート

このサーバは、Faster Whisperを利用した音声認識機能を提供します。以下の手順でサーバを起動し、Claudeデスクトップで使用することができます。

✨ 主な機能

• Faster Whisperを統合し、効率的な音声認識を実現
• バッチ処理による文字起こし速度の向上
• 利用可能なGPUがある場合、自動的にCUDAで加速
• 様々なモデル規模（tinyからlarge - v3まで）をサポート
• VTT字幕、SRT、JSONなどの出力形式をサポート
• フォルダ内の音声ファイルを一括で文字起こし可能
• モデルインスタンスをキャッシュし、繰り返しの読み込みを避ける
• GPUメモリに応じてバッチサイズを動的に調整

📦 インストール

依存関係

• Python 3.10+
• faster - whisper>=0.9.0
• torch==2.6.0+cu126
• torchaudio==2.6.0+cu126
• mcp[cli]>=1.2.0

インストール手順

1. このリポジトリをクローンまたはダウンロードします。
2. 仮想環境を作成し、アクティブ化することを推奨します。
3. 依存関係をインストールします。

pip install -r requirements.txt

PyTorchのインストールガイド

あなたのCUDAバージョンに合わせて適切なPyTorchバージョンをインストールします。

• CUDA 12.6:

pip install torch==2.6.0 torchvision==0.21.0 torchaudio==2.6.0 --index - url https://download.pytorch.org/whl/cu126

• CUDA 12.1:

pip install torch==2.5.1 torchvision==0.20.1 torchaudio==2.5.1 --index - url https://download.pytorch.org/whl/cu121

• CPUバージョン:

pip install torch==2.6.0 torchvision==0.21.0 torchaudio==2.6.0 --index - url https://download.pytorch.org/whl/cpu

nvcc --version または nvidia - smi でCUDAバージョンを確認できます。

💻 使用例

基本的な使用法

サーバの起動

Windowsシステムでは、start_server.bat を直接実行します。 その他のプラットフォームでは、以下のコマンドを実行します。

python whisper_server.py

Claudeデスクトップの設定

1. Claudeデスクトップの設定ファイルを開きます。

   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

2. Whisperサーバの設定を追加します。

{
  "mcpServers": {
    "whisper": {
      "command": "python",
      "args": ["-m", "whisper_server"],
      "env": {}
    }
  }
}

3. Claudeデスクトップを起動すると、文字起こし機能が利用可能になります。

🔧 技術詳細

文字起こしの流れ

1. 音声入力: wav、mp3などの複数の形式をサポート
2. モデル読み込み: Faster Whisperモデルを動的に読み込む
3. 音声認識: 効率的な音声文字起こしを実現
4. 結果出力: 標準のJSON形式で結果を返す

パフォーマンス最適化の提案

• GPUを使用して加速することで処理速度を向上させます。
• バッチサイズを適切に設定して、リソースの使用をバランスさせます。
• 定期的にモデルを更新して、最適なパフォーマンスを維持します。

🔗 プロジェクトの依存関係

• Whisper: https://github.com/openai/whisper
• Faster Whisper: https://github.com/guillaumekln/faster-whisper

🙏 特別な感謝

以下のツールとチームのサポートに感謝します。

• VS Code
• OpenAIのWhisperプロジェクト
• GuillaumeKlnのFaster Whisper実装