YouTube Subtitles MCP Server

YouTube Subtitles MCP Server

site icon
2025.03.03 0
Python字幕处理视频分析内容生成
YouTube Subtitles MCP Server 是一个模型上下文协议(MCP)服务器,允许AI助手(如Claude)下载和分析YouTube视频的字幕。该服务器提供了下载字幕、获取视频元数据、检测可用字幕语言等功能,并支持与Claude等MCP兼容的助手无缝集成。
View on GitHub

Overview

基本能力

产品定位

YouTube Subtitles MCP Server 是一个专门用于处理YouTube视频字幕的MCP服务器,旨在为AI助手提供字幕下载和分析功能。

核心功能

  • 下载YouTube字幕:从任何YouTube视频获取字幕
  • 语言支持:下载任何可用语言的字幕
  • 视频信息:获取视频元数据(标题、时长、上传日期等)
  • 多语言检测:列出视频所有可用的字幕语言
  • AI集成:与Claude等MCP兼容的助手无缝协作
  • Docker支持:支持容器化部署

适用场景

  • AI助手需要分析YouTube视频内容时
  • 需要获取视频字幕进行翻译或摘要时
  • 需要了解视频元数据时

工具列表

  1. get_video_info:获取YouTube视频的基本元数据
  2. list_subtitle_languages:列出视频可用的字幕语言
  3. download_subtitles:下载特定语言的字幕

常见问题解答

  1. 字幕不可用:并非所有YouTube视频都有字幕,尝试其他视频
  2. 缺少语言:有些视频只有原始语言的自动生成字幕
  3. Docker连接问题:确保容器正在运行且Claude Desktop配置正确

使用教程

使用依赖

  • Python 3.10+
  • yt-dlp
  • ffmpeg
  • MCP兼容客户端(如Claude Desktop)
  • Docker(可选,用于容器化部署)

安装ffmpeg的命令: - Ubuntu/Debian: sudo apt-get install ffmpeg - macOS (Homebrew): brew install ffmpeg - Windows: 从ffmpeg.org下载

安装教程

使用Docker(推荐)

  1. 克隆仓库: bash git clone https://github.com/setkyar/youtube-subtitles-mcp.git cd youtube-subtitles-mcp
  2. 构建并运行Docker: bash docker build -t mcp/youtube-subtitles .

手动安装

  1. 克隆仓库: bash git clone https://github.com/setkyar/youtube-subtitles-mcp.git cd youtube-subtitles-mcp
  2. 安装依赖: bash pip install "mcp[cli]>=1.2.0" yt-dlp
  3. 运行服务器: bash python youtube_subtitles_server.py

调试方式

查看Docker日志:

docker logs youtube-subtitles-mcp

许可证

该项目遵循 MIT 开源许可条款。