YouTube Transcript MCP Server

社区

获取 YouTube 视频字幕与元数据的 MCP 服务器

分类: 其他第 96 / 230
Stars: ★ 494 非常热门
传输方式: stdio（本地进程）
运行环境: Python · Docker · 预编译二进制
凭据: 无需凭据
许可证: MIT
最近提交: 5 天前
工具数: 4

57FMRS · C

这是一个由个人开发者维护的非官方 MCP 服务器，专注从 YouTube 视频提取字幕与元数据，提供四个工具并支持字幕分页与代理访问。适合需要把视频内容转为文本的用户；不涉及视频下载或播放，且依赖外部 YouTube 接口，可能受 IP 封禁影响。

最强项 · 文档质量 13/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

12/20

维护活跃度

12/20

文档质量

13/20

安装易用性

12/20

查看各项评分依据

可靠性 8/20: 清单与 README 对四个工具（get_transcript、get_timed_transcript、get_video_info、get_available_languages）的参数声明一致，只读抓取 YouTube 字幕，无破坏性副作用；但静态材料中未见任何启动日志、握手样例或错误处理说明，README 提到 CI 徽章但未提供可核验的 CI 工作流与测试文件，按校准规则可靠性不得超过 12，故给出 8：主路径可想象，依赖（youtube-transcript-api、网络、代理）和失败模式（IP 封禁、字幕不可用、分页游标失效）均未展示受控诊断。
安全与权限 12/20: 无红线行为：不含恶意代码、凭证窃取或隐蔽外传；文档提示通过 WEBSHARE_PROXY_USERNAME/PASSWORD 或 HTTP_PROXY/HTTPS_PROXY 传入代理凭证，属于用户显式配置，未发现硬编码令牌。扣分点：所有工具仅做外部网络请求且无权限范围、域名白名单或数据流披露，代理凭证以环境变量/命令行明文形式给出且未说明存储与日志脱敏，YouTube 抓取可能涉及 ToS 与隐私不确定性，确认与最小权限说明不完整。
维护活跃度 12/20: MIT 许可证明确，仓库未归档，481 stars 仅作发现信号；有版本号 0.7.2 与发布页、Docker Hub 及 goose/LM Studio 集成，显示一定维护活跃度。扣分点：静态材料未见提交历史、issue 响应记录、依赖更新策略或安全响应渠道，治理与版本节奏证据不足，故未给高分。
文档质量 13/20: 文档分层较清晰：工具清单、参数（含必填/可选与默认 en）、分页 50,000 字符与 --response-limit 调整、代理服务器配置、多客户端安装方式、许可证均有覆盖，示例可核验。扣分点：未说明认证/配额/速率限制、错误语义与故障排查步骤，next_cursor 的失效与并发场景未披露，默认语言假设也未解释。
安装易用性 12/20: 提供 .mcpb 一键包、uvx 与 git 安装示例、Claude Desktop 手写 JSON（含 --response-limit 变体）、LM Studio 深链与 Docker 镜像，主流客户端路径清楚。扣分点：依赖 uv/uvx 与网络环境，Docker 与代理细节指向外部页面，清单中 fileSha256 为空导致制品校验缺失，属需人工介入的脆弱点，按校准 setup 不超过 15，故给 12。

静态评测 · 未实际运行收录于 2026-09-18

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

需要把 YouTube 口播内容转为文本的写作与研究场景
需要在 MCP 客户端中快速查询视频信息的用户

不适合谁

需要下载或播放 YouTube 视频本身的场景
需要访问被限制内容且未配置代理的环境

所需权限

读取本地环境变量（如 WEBSHARE_PROXY_USERNAME、WEBSHARE_PROXY_PASSWORD、HTTP_PROXY、HTTPS_PROXY）
访问 YouTube 网络资源
通过代理服务器访问网络（如已配置）

风险与副作用

YouTube 可能对请求来源实施 IP 封禁，导致请求被拒
代理解析凭据以环境变量或命令行参数形式保存，可能被同机进程读取
字幕是外部不可信内容，可能包含错误或注入性文本
长视频字幕超出模型上下文限制，需要依赖分页处理

安装接入

准备工作

运行环境：Python · Docker · 预编译二进制

WEBSHARE_PROXY_USERNAME 可选密钥 Webshare住宅代理的用户名，可选，用于受限网络访问YouTube；在Webshare官网获取。

WEBSHARE_PROXY_PASSWORD 可选密钥 Webshare住宅代理的密码，可选，与用户名配合使用。

其他可选配置项（2 个）

HTTP_PROXY 可选通用代理服务器URL，可选，在访问YouTube受限的环境中使用。

HTTPS_PROXY 可选通用代理服务器URL，可选，用于HTTPS请求走代理。

安装 uv（uvx 命令依赖它）。
在 MCP 客户端（如 Claude Desktop）的配置文件中，在 mcpServers 下添加 mcp-youtube-transcript 条目，命令为 uvx，参数为 --from git+https://github.com/jkawamoto/mcp-youtube-transcript mcp-youtube-transcript。
也可从 Releases 页面下载 mcp-youtube-transcript.mcpb 并导入 Claude Desktop。
重启客户端生效。LM Studio 可使用官方按钮一键配置；goose 参照官方教程。

claude_desktop_config.json

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

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

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

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add youtube-transcript -- uvx --from git+https://github.com/jkawamoto/mcp-youtube-transcript mcp-youtube-transcript

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端工具列表中应出现 get_transcript、get_timed_transcript、get_video_info 和 get_available_languages 四个工具；调用 get_video_info 传入任意YouTube视频URL，能返回元数据即说明连接成功。

常见排障

请求失败并提示被封禁时，配置 Webshare 住宅代理或 HTTP/HTTPS 代理
字幕结果被截断时，使用返回的 next_cursor 获取下一页，或用 --response-limit 调小分页
字幕为空或语言不符时，先用 get_available_languages 确认可用语言，再指定 lang
uvx 命令不可用时，确认已安装 uv

试试这样问

连接成功后，可以直接对 AI 助手这样说：

获取这个YouTube视频的字幕：https://www.youtube.com/watch?v=dQw4w9WgXcQ
列出这个视频可用的字幕语言：https://www.youtube.com/watch?v=dQw4w9WgXcQ
给我这个视频的带时间戳字幕：https://www.youtube.com/watch?v=dQw4w9WgXcQ
这个YouTube视频的标题和元数据是什么？https://www.youtube.com/watch?v=dQw4w9WgXcQ

工具能力 4

get_transcript 只读

获取指定 YouTube 视频的字幕文本。参数：url（必填，视频完整 URL）、lang（可选，目标语言，默认 en）、next_cursor（可选，用于获取下一页字幕）。

get_timed_transcript 只读

获取指定 YouTube 视频带时间戳的字幕。参数：url（必填，视频完整 URL）、lang（可选，目标语言，默认 en）、next_cursor（可选，用于获取下一页字幕）。

get_video_info 只读

获取指定 YouTube 视频的元数据。参数：url（必填，视频完整 URL）。

get_available_languages 只读

获取指定视频可用的字幕语言。参数：url（必填，视频完整 URL）。

使用场景

为无法直接观看视频的用户提取 YouTube 视频字幕

基于带时间戳的字幕做内容摘要或检索

查询视频可用语言以便选择字幕语种

获取视频元数据用于整理和归档

支持客户端

Claude Desktop

Goose

LM Studio

依据项目文档列出，未经本站实测。

详细介绍

这是一个用于检索指定 YouTube 视频字幕的 MCP 服务器。它提供 get_transcript 获取普通字幕文本，get_timed_transcript 获取带时间戳的字幕，get_video_info 获取视频元数据，以及 get_available_languages 查询视频可用语言。字幕超过 50,000 字符时会自动分页，返回 next_cursor；可用 --response-limit 调整分页大小。当访问 YouTube 受限时，可通过环境变量或命令行参数配置 Webshare 住宅代理或 HTTP/HTTPS 代理。

YouTube Transcript MCP Server

选型与风险

适合谁

不适合谁

所需权限

风险与副作用

安装接入

准备工作

验证是否装好

常见排障

试试这样问

工具能力 4

使用场景

支持客户端

详细介绍

同类可选方案