MCP Video Digest

🚀 MCP ビデオ文字起こしツール

MCP Video 文字起こしツールは、強力なビデオ処理ソフトウェアです。YouTube やその他のプラットフォームからビデオをダウンロードし、その音声を文字に変換することができます。このツールは、さまざまな高度な音声認識技術を統合しており、ユーザーが迅速にビデオの文字起こしタスクを完了するのを支援します。

✨ 主な機能

• 多プラットフォーム対応：YouTube、Vimeo などの主要なビデオプラットフォームをサポートします。
• 高速ダウンロード：強力なダウンローダーが組み込まれており、さまざまなビデオ形式を処理できます。
• 高精度文字起こし：Deepgram、Gladia、AssemblyAI、Speechmatics などの著名な音声認識サービスを統合しています。
• 柔軟な設定：カスタム API キーとパラメータ設定をサポートします。
• スマートなエラー処理：ダウンロードと文字起こしの過程で発生する問題を自動的に検出し、修復します。

📁 プロジェクト構造

MCP-Video/
├── src/
│   ├── services/
│   │   ├── download/          # ダウンロードモジュール
│   │   │   └── __init__.py
│   │   └── transcription/     # 文字起こしモジュール
│   │       └── __init__.py
├── tests/
│   ├── test_env.py           # 環境テスト
│   ├── test_downloader.py    # ダウンローダーテスト
│   └── test_transcription.py  # 文字起こし器テスト
└── requirements.txt          # 依存関係管理ファイル

📦 インストール

インストール手順

1. プロジェクトリポジトリをクローンします：

git clone https://github.com/your-username/MCP-Video.git
cd MCP-Video

2. 依存関係をインストールします：

uv pip install -r requirements.txt

⚙️ 設定説明

環境変数の設定

プロジェクトのルートディレクトリに config.env ファイルを作成し、以下の内容を記入してください：

DEEPGRAM_API_KEY=your_key_here
GLADIA_API_KEY=your_key_here
ASSEMBLYAI_API_KEY=your_key_here
SPEECHMATICS_API_KEY=your_key_here

サービスの優先順位設定

# config.py
SERVICE_PRIORITY = [
    'Deepgram',
    'Gladia',
    'AssemblyAI',
    'Speechmatics'
]

💻 使用例

サービスの起動

uv run main.py

クライアント呼び出しの例

from mcp_video import MCPVideoProcessor

processor = MCPVideoProcessor()
# ビデオをダウンロード
video_path = processor.download_video('https://www.youtube.com/watch?v=12345')
# 音声を抽出
audio_path = processor.extract_audio(video_path)
# 音声を文字起こし
transcript = processor.transcribe(audio_path)
print(transcript.text)

🧪 テスト説明

テストの実行

uv test

🛠️ 開発ガイド

新しいサービスの追加

src/services/transcription/ ディレクトリに新しいクラスを作成し、BaseTranscriptionService を継承して transcribe メソッドを実装してください。

カスタムダウンローダーの開発

src/services/download/ ディレクトリ内の既存のダウンローダーを拡張または修正してください。YouTubeDownloader クラスを参考にすることをおすすめします。

📌 依存関係管理

• uv pip install package_name を使用して新しい依存関係をインストールします。
• uv pip freeze > requirements.txt を使用して現在の依存関係をエクスポートします。

⚠️ エラー処理

サービスには、以下の問題を自動的に処理できる完全なエラー処理メカニズムが組み込まれています。

• API リクエストの失敗
• ネットワーク接続の中断
• リソースクォータの超過
• ファイル操作の異常

📋 注意事項

1. 一時ファイルの保存に十分なシステムディスク容量があることを確認してください。
2. Python 3.11 以上のバージョンを使用することをおすすめします。
3. YouTube のダウンロードには、追加の認証設定が必要な場合があります。
4. API 呼び出し回数を適切に管理し、レート制限をトリガーしないようにしてください。

🆓 無料枠の説明

• Speechmatics：月に 8 時間の無料使用時間があります。
• Gladia：月に 10 時間の無料使用時間があります。
• AssemblyAI：月に $50 の無料枠があります。
• Deepgram：月に $200 の無料枠があります。

📄 ライセンス

このプロジェクトは MIT オープンソースライセンスに準拠しており、詳細は LICENSE ファイルを参照してください。