TubeToTranscript

TubeToTranscript MCP 服务：为 Claude、Cursor 和 AI Agent 提供 YouTube 字幕稿

由免费 YouTube 字幕稿生成器 TubeToTranscript 提供。 网站 · API 文档 · 远程 MCP 端点 · npm · 源代码

tubetotranscript-mcp 是一个 Model Context Protocol（MCP）服务， 让 AI 助手能够读取 YouTube 视频。让 Claude、Cursor 或任何 MCP 客户端总结视频、查找引述内容，或将讲座整理成笔记，它就会自行获取视频字幕，并提供时间戳、标题、频道和语言。

• 免费，无需 API 密钥或账号。 在你的电脑上运行，并读取 YouTube 已有的字幕。
• 适用于所有带字幕的视频：观看链接、Shorts、youtu.be 链接、嵌入式视频，或直接使用视频 ID。
• 视频提供的所有字幕语言，包括自动生成的字幕。
• 支持导出纯文本、带时间戳的文本、SRT 和 WebVTT 字幕。

快速开始

通过 npx 将 MCP 客户端指向此软件包。无需全局安装。

Claude Desktop

添加到 claude_desktop_config.json （macOS：~/Library/Application Support/Claude/，Windows：%APPDATA%\Claude\）：

{
  "mcpServers": {
    "tubetotranscript": {
      "command": "npx",
      "args": ["-y", "tubetotranscript-mcp"]
    }
  }
}

Cursor

添加到 .cursor/mcp.json：

{
  "mcpServers": {
    "tubetotranscript": {
      "command": "npx",
      "args": ["-y", "tubetotranscript-mcp"]
    }
  }
}

之后重启客户端，使其加载新的服务。

Claude Code

claude mcp add tubetotranscript -- npx -y tubetotranscript-mcp

你可以提出哪些请求

连接后，只需在聊天中粘贴 YouTube 链接：

• “用五个要点总结这个视频：https://youtu.be/…”
• “演讲者什么时候谈到定价？请给我时间戳。”
• “把这场讲座整理成学习笔记和十张抽认卡。”
• “这个视频有哪些字幕语言？”
• “将西班牙语字幕导出为 SRT 文件。”

工具

get_youtube_transcript

返回带时间戳的分段字幕稿、标题、频道、时长和可用语言。

参数	必填	说明
url_or_video_id	是	视频 URL（watch、shorts、youtu.be、embed）或 11 个字符的视频 ID
language	否	语言代码，如 en、es、fr。默认使用英语或主要字幕轨道

get_available_languages

列出视频可用的所有字幕轨道。

参数	必填	说明
url_or_video_id	是	视频 URL 或 11 个字符的视频 ID

export_youtube_transcript

将字幕稿转换为文本或字幕格式。

参数	必填	说明
url_or_video_id	是	视频 URL 或 11 个字符的视频 ID
format	是	txt、txt_with_timestamps、srt 或 vtt
language	否	语言代码

本地还是远程？

	本地（此软件包）	远程（tubetotranscript.com/mcp）
安装	npx -y tubetotranscript-mcp	无需安装，通过 URL 连接
传输方式	stdio	Streamable HTTP
API 密钥	无需	需要（获取免费密钥）
请求运行位置	你的电脑	TubeToTranscript 的服务器

支持填写远程 URL 的客户端，例如 Cursor：

{
  "mcpServers": {
    "tubetotranscript": {
      "url": "https://www.tubetotranscript.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

无需 AI 客户端

同样的转录文本也可在 TubeToTranscript 网站上免费获取，无需注册：

• YouTube 转录文本生成器：粘贴链接，即可阅读、搜索、复制或下载
• 适用于 ChatGPT 和 Claude 的 YouTube 转录文本：转录文本加提示词，适用于长视频
• YouTube 引言查找器：查找某句话的出现时间
• YouTube 转 JSON 和 YouTube 转 Excel 和 CSV 导出工具
• REST API：通过 HTTP 为脚本和应用提供相同数据

要求和限制

• Node.js 18 或更高版本（使用内置的 fetch）。
• 只能读取 YouTube 已提供的字幕。关闭字幕的视频会返回错误；此服务不会自行进行语音转文字。
• 字幕文本可能包含识别错误。请对照视频核实姓名、数字和引言。

许可证

MIT。由 TubeToTranscript 制作。