YouTube Transcript MCP Server

YouTube Transcript MCP 服务

一个 Model Context Protocol (MCP) 服务，可将 YouTube 视频的文字稿和元数据直接获取到大模型工作流中。

该服务专为 AI Agent 设计，可通过自动分页无缝处理长视频，并提供可靠的代理支持，以绕过 YouTube 的速率限制和 IP 封禁。

主要功能

• 丰富的文字稿获取：以多种语言获取原始文本、带时间戳的片段和视频元数据。
• 智能分块与分页：自动拆分较长的文字稿（默认：50,000 个字符），防止上下文窗口溢出，让模型轻松逐页处理数小时的视频内容。
• 可靠的代理支持：内置住宅代理（Webshare、ScrapingAnt）和标准 HTTP/HTTPS 代理支持，防止 IP 被封禁。
• 广泛兼容：适用于 Claude Desktop、Cursor、LM Studio、Goose 以及任何标准 MCP 客户端。

快速开始与安装

说明

你需要在系统上安装 uv，才能使用 uvx 命令。

此服务通过标准 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

• 图形界面（拖放）：从 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 扩展。

LM Studio

如需为 LM Studio 配置此服务，请点击下方按钮。

使用 Docker

此服务的 Docker 镜像可在 Docker Hub 获取。 详细使用说明和文档请参阅 Docker Hub 页面。

可用工具

该服务为 LLM Agent 注册了以下 MCP 工具：

工具	描述
get_transcript	获取 YouTube 视频 URL 对应的纯文本文字稿。
get_timed_transcript	获取包含开始时间和时长的文字稿片段。
get_available_languages	列出所有可用的文字稿语言（人工生成和自动生成）。
get_video_info	获取视频元数据，例如标题和频道信息。

工具参数与架构

• get_transcript

  • url（string，必填）：完整的 YouTube 视频 URL。
  • lang（string，可选）：首选语言代码（默认为 "en"）。
  • next_cursor（integer，可选）：用于获取长视频下一段内容的游标。

• get_timed_transcript

  • url（string，必填）：完整的 YouTube 视频 URL。
  • lang（string，可选）：首选语言代码（默认为 "en"）。
  • next_cursor（integer，可选）：用于获取下一段内容的游标。

• get_available_languages

  • url（string，必填）：完整的 YouTube 视频 URL。

• get_video_info

  • url（string，必填）：完整的 YouTube 视频 URL。

高级配置

处理长视频（分页）

长视频（例如讲座、会议和播客节目）很容易超出 LLM 的上下文令牌限制。 默认情况下，超过 50,000 个字符的文字稿会被分块。如果响应被拆分， 系统会提供 next_cursor，以便 LLM Agent 自主获取剩余内容。

如需自定义分块字符数限制，请提供 --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 文件。