🚀 YouTube转录MCP服务器
YouTube转录MCP服务器可获取YouTube视频的转录内容。它借助MCP（Model Context Protocol）协议，让Claude等AI模型能轻松利用YouTube视频的字幕数据。
✨ 主要特性
- 从YouTube视频URL中提取转录内容。
- 支持多语言转录，如韩语、英语等。
- 同时支持自动生成和手动生成的字幕。
- 可查询可用的转录内容列表。
📦 安装指南
1. 克隆仓库
git clone
cd youtube_transcript_mcp
2. 创建并激活虚拟环境
python3 -m venv venv
source venv/bin/activate # Linux/Mac
# 或者在Windows系统下：venv\Scripts\activate
3. 安装依赖项
pip install -r requirements.txt
📚 详细文档
Claude Desktop配置
若要在Claude Desktop中使用此MCP服务器，需修改Claude配置文件。
- macOS系统：Claude Desktop配置文件路径为
~/Library/Application Support/Claude/claude_desktop_config.json。 - Windows系统：Claude Desktop配置文件路径为
%APPDATA%\Claude\claude_desktop_config.json。
请在配置文件中添加以下内容：
{
"mcpServers": {
"youtube-transcript": {
"command": "/path/to/your/youtube_transcript_mcp/venv/bin/python",
"args": ["/path/to/your/youtube_transcript_mcp/youtube_transcript_mcp_server.py"],
"env": {}
}
}
}
⚠️ 重要提示：请将 /path/to/your/youtube_transcript_mcp 替换为实际的项目路径。
支持的URL格式
https://www.youtube.com/watch?v=VIDEO_IDhttps://youtu.be/VIDEO_IDVIDEO_ID（仅11位视频ID）
支持的语言
- 韩语 (ko) - 默认值
- 英语 (en)
- 其他YouTube支持的所有语言
若请求的语言不可用，服务器将按韩语 → 英语 → 自动生成字幕的顺序尝试获取。
💻 使用示例
在Claude Desktop完成配置后，可按以下方式使用：
基础用法
获取转录内容
请获取此YouTube视频的转录内容：https://www.youtube.com/watch?v=VIDEO_ID
获取特定语言的转录内容
请获取此视频的英语转录内容：https://www.youtube.com/watch?v=VIDEO_ID
查询可用的转录内容列表
请显示此视频可用的转录内容列表：https://www.youtube.com/watch?v=VIDEO_ID
🔧 技术细节
API工具
此MCP服务器提供以下两个工具：
1. get_youtube_transcript
- 说明：获取YouTube视频的转录内容。
- 参数：
url（必需）：YouTube视频URL。language（可选，默认值："ko"）：语言代码。
2. list_available_transcripts
- 说明：获取可用的转录内容列表。
- 参数：
url（必需）：YouTube视频URL。
问题解决
配置未生效
- 完全关闭并重新启动Claude Desktop。
- 确认配置文件路径是否正确。
- 确认虚拟环境是否已激活。
无法找到转录内容
- 该视频可能没有字幕。
- 视频可能为私有视频或访问受限。
- 可使用
list_available_transcripts工具查看可用语言。
依赖项
mcp>=0.8.0：Model Context Protocol库。youtube-transcript-api>=0.6.0：YouTube转录API。asyncio：异步处理。
📄 许可证
本项目遵循MIT许可证进行分发。