MCP Transcribe Online Vids

🚀 MCP オンラインビデオ文字起こし

このサーバーは FastMCP をベースに構築されており、大規模言語モデル（LLMs）が YouTube や Bilibili のオンラインビデオを文字起こしできるようにします。一時的なファイル保管には Replicate と 0x0.st を使用しています。

✨ 主な機能

• YouTube/Bilibili のビデオを文字起こしし、タイムスタンプ付きで出力
• 自動で音声を抽出し、フォーマットを変換
• WhisperX モデルを通じてクラウドで文字起こし
• 大きなファイルの一時的な保管

📦 インストール

前提条件

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

環境設定

# conda 環境を作成してアクティブ化
conda create --name mcp_transcribe_online_vids python=3.12
conda activate mcp_transcribe_online_vids

# 必要なシステムパッケージをインストール
conda install conda-forge::uv conda-forge::ffmpeg conda-forge::sqlite

# Python の依存関係をインストール
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)

# 非同期関数を実行
asyncio.run(get_transcript())

📚 ドキュメント

デプロイオプション

本番環境でのデプロイについては、FastMCP トランスポートオプション を参照してください。 トランスポートをカスタマイズするには、main.py の mcp.run() 呼び出しを変更します。

自前のファイルストレージ

ファイルストレージには自前の 0x0.st インスタンスを構築することを強くおすすめします。ホスティングガイド に従ってインスタンスを設定してください。

開発ロードマップ

• [ ] ビデオのメタデータ（タイトル、日付、説明）を取得するツールを追加
• [ ] YAML デプロイ構成を追加
• [ ] より多くのファイルストレージオプション（Google Cloud、S3）を追加
• [ ] WhisperX を使用したローカル文字起こし機能を完成させる
• [ ] Spotify ポッドキャストなどの他のメディアソースをサポート

コントリビューションガイド

プロジェクトに貢献する方法については、Contributing セクション を参照してください。

📄 ライセンス

[プロジェクトのライセンス情報]

📞 連絡先

• プロジェクトホームページ：[https://github.com/your-repository]
• 作者のメールアドレス：[あなたのメールアドレス]