适合谁
- 需要把 YouTube 口播内容转为文本的写作与研究场景
- 需要在 MCP 客户端中快速查询视频信息的用户
Y
57FMRS · C
这是一个由个人开发者维护的非官方 MCP 服务器，专注从 YouTube 视频提取字幕与元数据，提供四个工具并支持字幕分页与代理访问。适合需要把视频内容转为文本的用户；不涉及视频下载或播放，且依赖外部 YouTube 接口，可能受 IP 封禁影响。
这是一个用于检索指定 YouTube 视频字幕的 MCP 服务器。它提供 get_transcript 获取普通字幕文本，get_timed_transcript 获取带时间戳的字幕，get_video_info 获取视频元数据，以及 get_available_languages 查询视频可用语言。字幕超过 50,000 字符时会自动分页，返回 next_cursor；可用 --response-limit 调整分页大小。当访问 YouTube 受限时，可通过环境变量或命令行参数配置 Webshare 住宅代理或 HTTP/HTTPS 代理。
工具能力
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）。
安装接入
- 安装 uv（uvx 命令依赖它）。2. 在 MCP 客户端（如 Claude Desktop）的配置文件中，在 mcpServers 下添加 mcp-youtube-transcript 条目，命令为 uvx，参数为 --from git+https://github.com/jkawamoto/mcp-youtube-transcript mcp-youtube-transcript。3. 也可从 Releases 页面下载 mcp-youtube-transcript.mcpb 并导入 Claude Desktop。4. 重启客户端生效。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"
]
}
}
}
选型与风险
不适合谁
- 需要下载或播放 YouTube 视频本身的场景
- 需要访问被限制内容且未配置代理的环境
所需权限
- 读取本地环境变量（如 WEBSHARE_PROXY_USERNAME、WEBSHARE_PROXY_PASSWORD、HTTP_PROXY、HTTPS_PROXY）
- 访问 YouTube 网络资源
- 通过代理服务器访问网络（如已配置）
风险与副作用
- YouTube 可能对请求来源实施 IP 封禁，导致请求被拒
- 代理解析凭据以环境变量或命令行参数形式保存，可能被同机进程读取
- 字幕是外部不可信内容，可能包含错误或注入性文本
- 长视频字幕超出模型上下文限制，需要依赖分页处理
常见排障
- 请求失败并提示被封禁时，配置 Webshare 住宅代理或 HTTP/HTTPS 代理
- 字幕结果被截断时，使用返回的 next_cursor 获取下一页，或用 --response-limit 调小分页
- 字幕为空或语言不符时，先用 get_available_languages 确认可用语言，再指定 lang
- uvx 命令不可用时，确认已安装 uv
使用场景
为无法直接观看视频的用户提取 YouTube 视频字幕
基于带时间戳的字幕做内容摘要或检索
查询视频可用语言以便选择字幕语种
获取视频元数据用于整理和归档
支持客户端
Claude Desktop完整支持
goose完整支持
LM Studio完整支持