YouTube Transcript MCP Server

YouTube Transcript MCP Server

site icon
2025.03.26 11
PythonYouTube 字幕获取视频内容转换内容生成
mcp-youtube-transcript 是一个用于获取 YouTube 视频字幕的 MCP 服务器。它能够根据提供的 YouTube 视频 URL 获取对应的字幕内容,并支持多语言选择。该服务适用于需要批量处理或自动化获取 YouTube 视频字幕的场景。
View on GitHub

Overview

基本能力

产品定位

mcp-youtube-transcript 是一个专门用于获取 YouTube 视频字幕的服务,旨在为开发者提供便捷的 YouTube 字幕获取接口。

核心功能

  • 获取指定 YouTube 视频的字幕
  • 支持多语言字幕选择(默认英语)
  • 支持通过代理服务器访问 YouTube(如 WebShare 或其他代理)

适用场景

  • 需要批量获取 YouTube 视频字幕的研究或分析项目
  • 需要将 YouTube 视频内容转换为文本的应用开发
  • 在多语言环境下需要获取特定语言字幕的场景

工具列表

  • get_transcript: 获取指定 YouTube 视频的字幕
  • 参数:
    • url (string, 必需): YouTube 视频的完整 URL
    • lang (string, 可选): 字幕语言,默认为 en

常见问题解答

  • 如何解决 IP 被封锁问题? 可以通过设置代理服务器(如 WebShare)来绕过 IP 封锁

使用教程

使用依赖

  • 需要安装 Python 环境
  • 需要安装 Goose CLI 或 Claude Desktop(根据使用场景)

安装教程

对于 Goose CLI

编辑配置文件 ~/.config/goose/config.yaml:

extensions:
  youtube-transcript:
    name: Youtube Transcript
    cmd: uvx
    args: [--from, git+https://github.com/jkawamoto/mcp-youtube-transcript, mcp-youtube-transcript]
    enabled: true
    type: stdio

对于 Goose Desktop

添加新扩展: - 类型: Standard IO - ID: youtube-transcript - 名称: Youtube Transcript - 描述: Retrieve transcripts of YouTube videos - 命令: uvx --from git+https://github.com/jkawamoto/mcp-youtube-transcript mcp-youtube-transcript

对于 Claude Desktop

编辑 claude_desktop_config.json:

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

通过 Smithery 安装

npx -y @smithery/cli install @jkawamoto/mcp-youtube-transcript --client claude

调试方式

  • 检查代理设置是否正确(如使用代理)
  • 验证 YouTube URL 是否正确
  • 检查网络连接是否正常

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。