Youtube Transcript MCP

🚀 YouTube Transcript MCP Server

YouTube動画のトランスクリプトを取得するMCP（Model Context Protocol）サーバーです。ClaudeなどのAIモデルがYouTube動画の字幕データを簡単に利用できるようにします。

✨ 主な機能

• YouTube動画のURLからトランスクリプトを抽出する
• 多言語のトランスクリプトをサポートする（韓国語、英語など）
• 自動生成と手動生成の字幕の両方をサポートする
• 利用可能なトランスクリプトのリストを照会する

📦 インストール

1. リポジトリをクローンする

   git clone <repository-url>
   cd youtube_transcript_mcp
   

2. 仮想環境を作成してアクティブにする

   python3 -m venv venv
   source venv/bin/activate  # Linux/Mac
   # またはWindowsの場合: venv\Scripts\activate
   

3. 依存関係をインストールする

   pip install -r requirements.txt
   

Claude Desktopの設定

Claude DesktopでこのMCPサーバーを使用するには、Claudeの設定ファイルを編集する必要があります。

macOS

Claude Desktopの設定ファイルの場所: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows

Claude Desktopの設定ファイルの場所: %APPDATA%\Claude\claude_desktop_config.json

設定ファイルに以下の内容を追加してください:

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "/path/to/your/youtube_transcript_mcp/venv/bin/python",
      "args": ["/path/to/your/youtube_transcript_mcp/youtube_transcript_mcp_server.py"],
      "env": {}
    }
  }
}

重要: /path/to/your/youtube_transcript_mcpを実際のプロジェクトのパスに置き換えてください。

💻 使用例

Claude Desktopで設定が完了すると、以下のように使用できます。

基本的な使用法

このYouTube動画のトランスクリプトを取得してください: https://www.youtube.com/watch?v=VIDEO_ID

高度な使用法

この動画の英語のトランスクリプトを取得してください: https://www.youtube.com/watch?v=VIDEO_ID

利用可能なトランスクリプトのリストを照会する

この動画で利用可能なトランスクリプトのリストを表示してください: https://www.youtube.com/watch?v=VIDEO_ID

📚 ドキュメント

サポートされるURL形式

• https://www.youtube.com/watch?v=VIDEO_ID
• https://youtu.be/VIDEO_ID
• VIDEO_ID（11文字のビデオIDのみ）

サポートされる言語

• 韓国語 (ko) - デフォルト
• 英語 (en)
• YouTubeでサポートされるその他のすべての言語

サーバーは、要求された言語が利用できない場合、自動的に韓国語 → 英語 → 自動生成字幕の順で試みます。

APIツール

このMCPサーバーは、以下の2つのツールを提供します。

1. get_youtube_transcript

• 説明: YouTube動画のトランスクリプトを取得します
• パラメーター:
  • url (必須): YouTube動画のURL
  • language (オプション、デフォルト: "ko"): 言語コード

2. list_available_transcripts

• 説明: 利用可能なトランスクリプトのリストを取得します
• パラメーター:
  • url (必須): YouTube動画のURL

問題解決

設定が適用されない場合

1. Claude Desktopを完全に終了してから再起動してください
2. 設定ファイルのパスが正しいことを確認してください
3. 仮想環境がアクティブになっていることを確認してください

トランスクリプトが見つからない場合

• その動画に字幕がない可能性があります
• 非公開動画またはアクセスが制限された動画である可能性があります
• list_available_transcriptsツールを使用して、利用可能な言語を確認してみてください

依存関係

• mcp>=0.8.0: Model Context Protocolライブラリ
• youtube-transcript-api>=0.6.0: YouTubeトランスクリプトAPI
• asyncio: 非同期処理

📄 ライセンス

このプロジェクトはMITライセンスの下で配布されます。