MCP Transcribe Online Videos

MCP オンライン動画の文字起こし

Replicate と 0x0.st を一時的なファイルホスティングに利用して、LLM が YouTube や Bilibili のオンライン動画にアクセスし、文字起こしできる FastMCP サーバーです。

機能

• YouTube／Bilibili の動画をタイムスタンプ付きで文字起こし
• 音声の自動抽出とフォーマット変換
• WhisperX モデルを使用したクラウドベースの文字起こし
• 大容量ファイル向けの一時的なファイルホスティング

インストール

前提条件

• Python 3.12+
• Conda（環境管理に推奨）

環境のセットアップ

# Create and activate a conda environment
conda create --name mcp_transcribe_online_vids python=3.12
conda activate mcp_transcribe_online_vids

# Install required system packages
conda install conda-forge::uv conda-forge::ffmpeg conda-forge::sqlite

# Install Python dependencies
uv pip install -r requirements.txt

設定

1. .env.template ファイルを .env にコピーします：

   cp .env.template .env
   

2. .env ファイルを編集して、認証情報を設定します：

   • REPLICATE_API_TOKEN：Replicate の API キーページから取得します
   • ZERO_X_URL：0x0.st インスタンスの URL（デフォルト：パブリックインスタンス）
   • TEMP_FILE_PATH：一時ファイル用のディレクトリ
   • LOCAL_FILE_SIZE_LIMIT：API に直接アップロードできるファイルの最大サイズ（MB）

使い方

サーバーの起動

python main.py

利用可能なツール

• get_youtube_transcript(url)：YouTube 動画の文字起こし
• get_bilibili_transcript(url)：Bilibili 動画の文字起こし

例

from fastmcp import MCPClient
import asyncio

async def get_transcript():
    client = MCPClient("http://localhost:8000")
    async with client:
        transcript = await client.call_tool("get_youtube_transcript",
            {"url": "https://www.youtube.com/watch?v=dQw********"})
        print(transcript)

# Run the async function
asyncio.run(get_transcript())

デプロイオプション

本番環境でサーバーをデプロイする方法については、FastMCP のトランスポートオプションを参照してください。

トランスポートをカスタマイズするには、main.py の mcp.run() 呼び出しを変更してください。

ファイルストレージのセルフホスティング

ファイルストレージ用に、独自の 0x0.st インスタンスをホストすることを強くおすすめします。ホスティング手順に従って、独自のインスタンスをセットアップしてください。

ロードマップ

• 動画のメタデータ（タイトル、日付、説明）を取得するツールを追加
• デプロイ設定用の YAML 設定を追加
• ファイルホスティングの選択肢を追加（Google Cloud、S3）
• WhisperX を使用したローカルでの文字起こしオプションを完成
• Spotify のポッドキャストなど、ほかのメディアソースに対応

コントリビューション

1. 開発用の依存関係をインストールします：

   pip install pre-commit
   pre-commit install
   

2. コードを提出する前に、pre-commit チェックを実行します：

   pre-commit run --all-files
   

ライセンス

GPL-3.0 ライセンスの下でライセンスされています