모델 컨텍스트 프로토콜(MCP) 서버 이 도구는 유튜브 영상의 대본과 메타데이터를 LLM 워크플로우로 직접 가져오는 것입니다.

AI 에이전트를 위해 특별히 설계된 이 기능은 자동 페이지네이션을 통해 장편 동영상을 원활하게 처리합니다 그리고 유튜브 속도 제한과 IP 차단을 우회할 수 있는 강력한 프록시 지원을 제공합니다.

주요 특징

• 풍부한 전사기록 검색: 원시 텍스트, 타임스탬프가 포함된 세그먼트, 그리고 여러 언어의 비디오 메타데이터를 가져올 수 있습니다.
• 스마트 청킹 및 페이지네이션: 문맥 차단을 위해 긴 전사본(기본값: 50,000자)을 자동으로 청크화함 창 오버플로우를 통해 모델들이 수 시간 분량의 영상을 손봐 가볍게 넘길 수 있습니다.
• 복원력 있는 프록시 지원: 주거용 프록시(Webshare, ScrapingAnt) 내장 지원. IP 차단을 방지하기 위한 표준 HTTP/HTTPS 프록시가 있습니다.
• 범용 호환성: Claude Desktop, 커서, 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):