YouTube 字幕获取 MCP 服务器

该MCP服务器用于获取指定YouTube视频的字幕内容。

功能工具

本MCP服务器提供以下功能工具：

`get_transcript`

获取指定YouTube视频的字幕内容。

参数

url (字符串): YouTube视频完整URL。此为必填字段。
lang (字符串，可选): 字幕语言。默认值为en（英语）。
next_cursor (字符串，可选): 用于获取字幕下一页内容的游标。

`get_timed_transcript`

获取带时间戳的YouTube视频字幕。

参数

url (字符串): YouTube视频完整URL。此为必填字段。
lang (字符串，可选): 字幕语言。默认值为en（英语）。
next_cursor (字符串，可选): 用于获取字幕下一页内容的游标。

`get_video_info`

获取指定YouTube视频的元数据信息。

参数

url (字符串): YouTube视频完整URL。此为必填字段。

安装指南

[!注意] 使用uvx命令前需要先安装uv。

适用于Goose平台

详细安装教程请参考： YouTube字幕扩展。

适用于Claude桌面版

从发布页面下载最新的MCP安装包mcp-youtube-transcript.mcpb，然后直接打开下载的.mcpb文件或将其拖拽到Claude桌面版的设置窗口中。

您也可以手动为Claude桌面版配置此服务。编辑claude_desktop_config.json文件，在mcpServers下添加如下配置：

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

编辑完成后请重启应用。更多信息请参阅： Claude桌面版用户指南 - 模型上下文协议。

适用于LM Studio

点击下方按钮即可为LM Studio配置此服务。

使用Docker

本服务的Docker镜像已发布于Docker Hub。详细使用说明请参考Docker Hub页面。

响应分页

获取较长视频的字幕时，内容可能会超出LLM的token限制。为避免此问题，本服务会对超过50,000字符的字幕进行分页处理。当字幕被分页时，响应中将包含next_cursor字段。要获取后续内容，请在请求中包含此next_cursor值。

不同LLM和语言的token限制各不相同。如需更小的分页尺寸，可通过--response-limit命令行参数进行调整。例如以下配置将响应分页限制为每页不超过15,000字符：

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

使用代理服务器

在YouTube访问受限的网络环境中，可通过代理服务器进行连接。

使用Webshare住宅代理时，可通过环境变量WEBSHARE_PROXY_USERNAME和WEBSHARE_PROXY_PASSWORD，或命令行参数--webshare-proxy-username和--webshare-proxy-password设置用户名和密码。

使用其他代理服务器时，可通过环境变量HTTP_PROXY或HTTPS_PROXY，或命令行参数--http-proxy和--https-proxy设置代理服务器地址。

更多详情请参考：绕过IP封禁 - YouTube字幕API。

许可证

本应用采用MIT许可证。完整许可条款请参阅LICENSE文件。