作者 jkawamoto · jkawamoto/mcp-youtube-transcript
从任何 YouTube 视频中提取文字稿（带时间戳）、元数据和语言列表 — 让 Claude 能在数秒内总结、引用或精确定位一小时视频的内容。
mcp-youtube-transcript 提供 4 个工具来获取原始文字稿、带时间戳的文字稿、视频元数据和可用语言。长文字稿会自动在 50k 字符处分页。支持 Webshare / 自定义 HTTP 代理来应对 YouTube 的速率限制或 IP 封禁。
--response-limit 可配置）uvx mcp-youtube-transcript 或 Claude Desktop 的 .mcpb 包运行%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"youtube-transcript": {
"command": "uvx",
"args": [
"mcp-youtube-transcript"
],
"_inferred": true
}
}
}打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。
{
"mcpServers": {
"youtube-transcript": {
"command": "uvx",
"args": [
"mcp-youtube-transcript"
],
"_inferred": true
}
}
}Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。
{
"mcpServers": {
"youtube-transcript": {
"command": "uvx",
"args": [
"mcp-youtube-transcript"
],
"_inferred": true
}
}
}点击 Cline 侧栏中的 MCP Servers 图标，然后选 "Edit Configuration"。
{
"mcpServers": {
"youtube-transcript": {
"command": "uvx",
"args": [
"mcp-youtube-transcript"
],
"_inferred": true
}
}
}格式与 Claude Desktop 相同。重启 Windsurf 生效。
{
"mcpServers": [
{
"name": "youtube-transcript",
"command": "uvx",
"args": [
"mcp-youtube-transcript"
]
}
]
}Continue 使用服务器对象数组，而非映射。
{
"context_servers": {
"youtube-transcript": {
"command": {
"path": "uvx",
"args": [
"mcp-youtube-transcript"
]
}
}
}
}加入 context_servers。Zed 保存后热重载。
claude mcp add youtube-transcript -- uvx mcp-youtube-transcript一行命令搞定。用 claude mcp list 验证，claude mcp remove 卸载。
何时使用： 你无法看完整个视频，但需要关键要点（并用时间戳引用它们）。
结果： 可消化的摘要，你可以在 2 分钟内分享到团队 Slack。
何时使用： 你想在 100 多集的节目中询问「哪一集讨论了 X？」。
结果： 你拥有并控制的可搜索播客库。
何时使用： 你想阅读西班牙语演讲的英文版本，而不需要自己运行 ML 翻译。
结果： 可读的翻译文字稿。
| 工具 | 输入参数 | 何时调用 | 成本 |
|---|---|---|---|
| get_transcript | url_or_id: str, language?: str | 你只需要文本，不需要时间戳 | free |
| get_timed_transcript | url_or_id, language? | 你需要时间戳来引用或生成章节 | free |
| get_video_info | url_or_id | 获取上下文或索引的元数据 | free |
| get_available_languages | url_or_id | 在尝试获取前检查字幕可用性 | free |
HTTP 429 Too Many Requests你的 IP 被 YouTube 速率限制。通过 env 变量配置 Webshare 代理或等待 30-60 分钟。
尝试从另一个 IP 访问同一 URLNo transcript available视频没有字幕。先调用 get_available_languages；如果返回空，则跳过。
Age-restricted / region-locked video这个 MCP 不支持此情况。无解决方案 — 使用带认证的官方 YouTube Data API。
Python install issues (uvx)先安装 uv：curl -LsSf https://astral.sh/uv/install.sh | sh。需要 Python 3.10+。
uv --version| 替代方案 | 何时用它替代 | 权衡 |
|---|---|---|
| YouTube Data API + 官方 MCP 包装 | 你需要官方、经过认证的访问 | 需要 Google API 密钥；有配额限制；不直接提供文字稿文本 |
| yt-dlp MCP | 你还想下载视频/音频，而不仅仅是文字稿 | 更重；下载媒体文件 |