Mcp Youtube Transcript

io.github.jkawamoto由 GitHub 帳號 jkawamoto 發布v0.8.4更新於 Nov 14, 2026

An MCP server retrieving transcripts of YouTube videos

發布方自己的服務:Transcript

概覽

AI 產生的概覽

把 YouTube 影片的字幕與中繼資料取回給助理使用,支援選擇語言,並對長影片分頁。

可以做什麼
  • 取得 YouTube 影片的純文字字幕
  • 取得含開始時間與時長的分段字幕
  • 列出可用的字幕語言,包含人工與自動產生
  • 讀取影片中繼資料,例如標題與頻道資訊
  • 透過游標分頁讀取超長字幕
適用情境
適合讓助理不必離開對話,就能摘要、引用、翻譯或搜尋 YouTube 影片、講座、播客與研討會演講的口述內容。
執行需求
以 stdio 方式在本機執行;README 建議使用 uv/uvx(也可用 Docker 映像或 Claude Desktop 的 .mcpb 套件)。需要能連線至 YouTube 的網路。選用代理憑證可透過 WEBSHARE_PROXY_USERNAME、WEBSHARE_PROXY_PASSWORD、SCRAPINGANT_API_TOKEN 或 HTTP_PROXY/HTTPS_PROXY 提供。
安裝前請注意
代理憑證與 ScrapingAnt API 權杖以環境變數或命令列參數傳入,請勿寫進共用設定。ScrapingAnt 需付費訂閱,住宅代理會消耗更多額度。影片網址與代理流量會傳送給 YouTube 及所選代理服務商。部分影片或來自資料中心 IP 的請求可能取不到字幕。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Mcp Youtube Transcript,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

English | 日本語

YouTube Transcript MCP Server

[uv] [Python Application] [pre-commit] [GitHub License] [Dockerhub]

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.

[mcp-youtube-transcript]

The header image was generated with Muse (Muse Image).

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):

json
{  "mcpServers": {    "youtube-transcript": {      "command": "uvx",      "args": [        "--from",        "git+https://github.com/jkawamoto/mcp-youtube-transcript",        "mcp-youtube-transcript"      ]    }  }}
Client-Specific Setup Guides (Click to expand)
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):
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
Cursor
  1. Go to Cursor Settings > Features > MCP Servers.
  2. Click + Add New MCP Server.
  3. Name: youtube-transcript, Type: command.
  4. Command: uvx --from git+https://github.com/jkawamoto/mcp-youtube-transcript mcp-youtube-transcript
Goose

Please refer to this tutorial for detailed installation instructions: YouTube Transcript Extension.

LM Studio

To configure this server for LM Studio, click the button below.

[Add MCP Server youtube-transcript to LM Studio]

Using Docker

A Docker image for this server is available on Docker Hub. Please refer to the Docker Hub page for detailed usage instructions and documentation.

Available Tools

The server registers the following MCP tools for LLM agents:

ToolDescription
get_transcriptRetrieves the plain-text transcript for a YouTube video URL.
get_timed_transcriptRetrieves transcript segments with start times and durations.
get_available_languagesLists all available transcript languages (manual & auto-generated).
get_video_infoFetches video metadata such as title and channel information.
Tool Parameters & Schema
  • get_transcript

    • url (string, required): Full YouTube video URL.
    • lang (string, optional): Preferred language code (defaults to "en").
    • next_cursor (integer, optional): Cursor to fetch the next chunk for long videos.
  • get_timed_transcript

    • url (string, required): Full YouTube video URL.
    • lang (string, optional): Preferred language code (defaults to "en").
    • next_cursor (integer, optional): Cursor to fetch the next chunk.
  • get_available_languages

    • url (string, required): Full YouTube video URL.
  • get_video_info

    • url (string, required): Full YouTube video URL.

Advanced Configuration

Handling Long Videos (Pagination)

Long videos (e.g., lectures, conferences, podcast episodes) can quickly exceed LLM token context limits. By default, transcripts exceeding 50,000 characters are chunked. When a response is split, a next_cursor is provided so the LLM agent can autonomously query the rest.

To customize the chunk character limit, supply --response-limit. To disable pagination and fetch the entire transcript at once, set --response-limit to a negative value (e.g., -1):

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

Avoiding IP Bans (Proxy Setup)

YouTube aggressively blocks automated transcript requests from cloud providers and data center IPs. Using residential or rotating proxies ensures uninterrupted access.

1. Webshare Residential Proxy

Set credentials via environment variables or command-line flags:

json
{  "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 equivalents: --webshare-proxy-username and --webshare-proxy-password)

2. ScrapingAnt

If using ScrapingAnt, supply your API token:

json
{  "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 equivalent: --scrapingant-api-token)

Accessing YouTube requires a paid ScrapingAnt Web Scraping API subscription. YouTube access requires residential proxies, which consume more ScrapingAnt credits than standard proxy requests. See the ScrapingAnt credit cost documentation for details.

3. Standard / Generic HTTP & HTTPS Proxies

Specify custom proxy endpoints via HTTP_PROXY / HTTPS_PROXY (or --http-proxy / --https-proxy):

json
{  "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"      }    }  }}

For more details, please visit: Working around IP bans - YouTube Transcript API.

License

This application is licensed under the MIT License. See the LICENSE file for more details.

來源:README.md,提交 604e1f4

工具

0
SourceWeft 曾在隔離沙箱中以無憑證方式啟動該軟體包一次,以列出其工具,但未能完成:該軟體包類型無法在沙箱中執行。

版本歷史

5
  1. v0.8.4最新Nov 14, 2026
  2. v0.8.3Oct 29, 2026
  3. v0.8.1Oct 21, 2026
  4. v0.8.0Sep 24, 2026
  5. v0.7.2Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Transcript 整合