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 的令牌大小限制。为避免此问题，本服务器会将超过 50,000 字符的字幕进行分页。如果字幕被分页，响应中将包含 next_cursor 字段。要获取后续部分，请在请求中包含此 next_cursor 值。

令牌大小限制因您使用的 LLM 和语言而异。如果需要将响应拆分成更小的块，可以使用 --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 设置代理服务器 URL。

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

许可证

本应用采用 MIT 许可证。详见 LICENSE 文件。