YouTube Transcript MCP Server

YouTube Transcript MCP Server

YouTube 動画のトランスクリプトとメタデータを取得し、LLM のワークフローに直接取り込む Model Context Protocol（MCP） サーバーです。

AI エージェント向けに特化して設計されており、自動ページネーションで長時間の動画にもシームレスに対応します。 また、YouTube のレート制限や IP ブロックを回避するための、堅牢なプロキシサポートも備えています。

主な機能

• 充実したトランスクリプト取得：複数の言語で、テキスト、タイムスタンプ付きセグメント、動画メタデータを取得します。
• スマートなチャンク分割とページネーション：長いトランスクリプトを自動的にチャンクに分割し（デフォルト：50,000 文字）、コンテキストウィンドウの 超過を防ぎます。モデルは何時間もの動画も簡単にページ送りしながら確認できます。
• 堅牢なプロキシサポート：IP ブロックを防ぐため、住宅用プロキシ（Webshare、ScrapingAnt）と標準の HTTP/HTTPS プロキシを 標準でサポートしています。
• 幅広い互換性：Claude Desktop、Cursor、LM Studio、Goose、および標準的な MCP クライアントで動作します。

クイックスタートとインストール

メモ

uvx コマンドを使用するには、システムに uv をインストールする必要があります。

このサーバーは標準の stdio を介して通信します。 ほとんどの MCP クライアントでは、uvx（Astral uv に含まれる）を使って直接実行できます。

一般的な設定（標準 MCP JSON）

クライアントの MCP 設定ファイル（通常は mcpServers の下）に、次のエントリーを追加します。

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/jkawamoto/mcp-youtube-transcript",
        "mcp-youtube-transcript"
      ]
    }
  }
}

クライアント別セットアップガイド（クリックして展開）

Claude Desktop

• GUI（ドラッグ＆ドロップ）：Releases ページ から .mcpb バンドルをダウンロードし、Claude Desktop の設定画面にドロップします。
• 手動設定：上記の JSON を claude_desktop_config.json に追加します（保存後、Claude Desktop を再起動してください）。
  • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows：%APPDATA%\Claude\claude_desktop_config.json

Cursor

1. Cursor Settings > Features > MCP Servers に移動します。
2. + Add New MCP Server をクリックします。
3. 名前：youtube-transcript、タイプ：command。
4. コマンド：uvx --from git+https://github.com/jkawamoto/mcp-youtube-transcript mcp-youtube-transcript

Goose

詳しいインストール手順については、次のチュートリアルを参照してください。 YouTube Transcript Extension。

LM Studio

LM Studio 用にこのサーバーを設定するには、下のボタンをクリックします。

Docker の使用

このサーバーの Docker イメージは Docker Hub で入手できます。 詳しい使用方法とドキュメントについては、Docker Hub のページを参照してください。

利用可能なツール

サーバーは、LLM エージェント向けに以下の MCP ツールを登録します。

ツール	説明
get_transcript	YouTube 動画 URL のプレーンテキストの文字起こしを取得します。
get_timed_transcript	開始時間と再生時間を含む文字起こしのセグメントを取得します。
get_available_languages	利用可能な文字起こし言語（手動生成および自動生成）の一覧を取得します。
get_video_info	タイトルやチャンネル情報など、動画のメタデータを取得します。

ツールのパラメーターとスキーマ

• get_transcript

  • url (string, required): YouTube 動画の完全な URL です。
  • lang (string, optional): 優先する言語コードです（デフォルトは "en"）。
  • next_cursor (integer, optional): 長い動画の次のチャンクを取得するためのカーソルです。

• get_timed_transcript

  • url (string, required): YouTube 動画の完全な URL です。
  • lang (string, optional): 優先する言語コードです（デフォルトは "en"）。
  • next_cursor (integer, optional): 次のチャンクを取得するためのカーソルです。

• get_available_languages

  • url (string, required): YouTube 動画の完全な URL です。

• get_video_info

  • url (string, required): YouTube 動画の完全な URL です。

高度な設定

長い動画への対応（ページネーション）

長い動画（講義、カンファレンス、ポッドキャストのエピソードなど）は、LLM のトークンコンテキスト上限をすぐに超えることがあります。 デフォルトでは、50,000 characters を超える文字起こしはチャンクに分割されます。応答が分割された場合は、 next_cursor が提供されるため、LLM エージェントは残りの部分を自動的に取得できます。

チャンクの文字数上限を変更するには、--response-limit を指定します。 ページネーションを無効にして文字起こし全体を一度に取得するには、--response-limit に負の値（例：-1）を設定します。

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/jkawamoto/mcp-youtube-transcript",
        "mcp-youtube-transcript",
        "--response-limit",
        "15000"
      ]
    }
  }
}

IP ブロックの回避（プロキシの設定）

YouTube は、クラウドプロバイダーやデータセンターの IP アドレスからの自動文字起こしリクエストを積極的にブロックします。 住宅用プロキシまたはローテーションプロキシを使用すると、アクセスを中断せずに利用できます。

1. Webshare 住宅用プロキシ

環境変数またはコマンドラインフラグを使って認証情報を設定します。

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/jkawamoto/mcp-youtube-transcript",
        "mcp-youtube-transcript"
      ],
      "env": {
        "WEBSHARE_PROXY_USERNAME": "your_username",
        "WEBSHARE_PROXY_PASSWORD": "your_password"
      }
    }
  }
}

(CLI での同等のオプション：--webshare-proxy-username および --webshare-proxy-password)

2. ScrapingAnt

ScrapingAnt を使用する場合は、API トークンを指定します。

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/jkawamoto/mcp-youtube-transcript",
        "mcp-youtube-transcript"
      ],
      "env": {
        "SCRAPINGANT_API_TOKEN": "your_api_token"
      }
    }
  }
}

(CLI での同等のオプション：--scrapingant-api-token)

YouTube にアクセスするには、有料の ScrapingAnt Web Scraping API サブスクリプションが必要です。 YouTube へのアクセスには住宅用プロキシが必要で、標準的なプロキシリクエストよりも多くの ScrapingAnt クレジットを消費します。 詳細は、ScrapingAnt のクレジット費用に関するドキュメントをご覧ください。

3. 標準／汎用 HTTP・HTTPS プロキシ

HTTP_PROXY／HTTPS_PROXY（または --http-proxy／--https-proxy）を使って、カスタムプロキシエンドポイントを指定します。

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/jkawamoto/mcp-youtube-transcript",
        "mcp-youtube-transcript"
      ],
      "env": {
        "HTTPS_PROXY": "http://username:[email protected]:8080"
      }
    }
  }
}

詳細については、以下をご覧ください。 IP ブロックの回避 - YouTube Transcript API。

ライセンス

このアプリケーションは MIT License の下でライセンスされています。詳細は LICENSE ファイルをご覧ください。