モデルコンテキストプロトコル(MCP)サーバー YouTube動画のトランスクリプトやメタデータを直接LLMのワークフローに取り込むことができます。

AIエージェント向けに特別に設計されており、長尺動画を自動ページ化でシームレスに処理します また、YouTubeのレート制限やIP禁止を回避するための堅牢なプロキシサポートも提供しています。

主な特徴

• リッチトランスクリプト検索:生テキスト、タイムスタンプ付きセグメント、複数の言語でビデオメタデータを取得します。
• スマートチャンク&ページ分け:長いトランスクリプトを自動的にチャンク化(デフォルト:50,000文字)で文脈を妨げます ウィンドウオーバーフローで、モデルが何時間もの動画を難なくページングできます。
• レジリエントプロキシサポート:住宅用プロキシ(Webshare、ScrapingAnt)への組み込みサポート IPブロックを防ぐための標準的なHTTP/HTTPSプロキシも使用しています。
• ユニバーサル互換性:Claude Desktop、Cursor、LM Studio、Goose、および標準的なMCPクライアントで動作します。

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

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

このサーバーは標準のstdioで通信します。 ほとんどのMCPクライアントはuvx(Astral uvの一部)を使って直接実行できます。

一般構成(標準MCP JSON)

YouTube Transcript MCP Server

A Model Context Protocol (MCP) server that fetches transcripts and metadata from YouTube videos directly into your LLM workflows.

Designed specifically for AI agents, it seamlessly handles long-form videos through automatic pagination and provides robust proxy support to circumvent YouTube rate limits and IP bans.

Key Features

• Rich Transcript Retrieval: Fetch raw text, timestamped segments, and video metadata in multiple languages.
• Smart Chunking & Pagination: Automatically chunks long transcripts (default: 50,000 characters) to prevent context window overflow, letting models page through hours of video effortlessly.
• Resilient Proxy Support: Built-in support for residential proxies (Webshare, ScrapingAnt) and standard HTTP/HTTPS proxies to prevent IP blocks.
• Universal Compatibility: Works with Claude Desktop, Cursor, LM Studio, Goose, and any standard MCP client.

Quick Start & Installation

[!NOTE] You’ll need uv installed on your system to use uvx command.

This server communicates via standard stdio. Most MCP clients can run it directly using uvx (part of Astral uv).

General Configuration (Standard MCP JSON)

Add this entry to your client’s MCP configuration file (typically under mcpServers):

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

Claude Desktop

• GUI (Drag & Drop): Download the .mcpb bundle from the Releases page and drop it into your Claude Desktop Settings.
• Manual Config: Add the JSON above to claude_desktop_config.json (restart Claude Desktop after saving):