
YouTube Subtitles MCP Server

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视频内容时
- 需要获取视频字幕进行翻译或摘要时
- 需要了解视频元数据时
工具列表
get_video_info
:获取YouTube视频的基本元数据list_subtitle_languages
:列出视频可用的字幕语言download_subtitles
:下载特定语言的字幕
常见问题解答
- 字幕不可用:并非所有YouTube视频都有字幕,尝试其他视频
- 缺少语言:有些视频只有原始语言的自动生成字幕
- 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(推荐)
- 克隆仓库:
bash git clone https://github.com/setkyar/youtube-subtitles-mcp.git cd youtube-subtitles-mcp
- 构建并运行Docker:
bash docker build -t mcp/youtube-subtitles .
手动安装
- 克隆仓库:
bash git clone https://github.com/setkyar/youtube-subtitles-mcp.git cd youtube-subtitles-mcp
- 安装依赖:
bash pip install "mcp[cli]>=1.2.0" yt-dlp
- 运行服务器:
bash python youtube_subtitles_server.py
调试方式
查看Docker日志:
docker logs youtube-subtitles-mcp