YouTube 字幕 MCP 服务器

此 MCP 服务器用于检索给定 YouTube 视频 URL 的字幕。

<a href="https://glama.ai/mcp/servers/of3kwtmlqp"><img width="380" height="200" src="https://gips2.baidu.com/it/u=1562124112,3746029861&fm=3081&app=3081&f=PNG?w=760&h=400" alt="YouTube 字幕服务器 MCP 服务器" /></a>

工具

此 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。此字段是必需的。

安装

[!NOTE] 您需要在系统上安装了uv，才能使用 uvx 命令。

对于代号为goose的环境

请参考以下教程以获取详细的安装说明： YouTube 字幕扩展。

对于 Claude Desktop

从发布页面下载最新的 MCP 包 mcp-youtube-transcript.mcpb， 然后打开下载的 .mcpb 文件或将其拖入 Claude Desktop 的设置窗口。

您也可以手动为此服务器配置 Claude Desktop。 编辑 claude_desktop_config.json 文件，在 mcpServers 下添加以下条目：

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

编辑后，请重新启动应用程序。 更多信息，请参阅：对于 Claude Desktop 用户 - 模型上下文协议。

对于 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文件。