YouTube转录MCP服务器
](https://pypi.org/project/yt-transcript-mcp/)   
提取、搜索和分析YouTube视频转录的MCP(模型上下文协议)服务器。适用于Claude Desktop、Cursor和任何兼容MCP的客户端。
特性
- 获取成绩单 -从任何YouTube视频中提取完整文字记录
- 搜索成绩单 -查找具有周围上下文的特定关键字
- 成绩单摘要 -获取分时间段的成绩单,以便于分析
- 批处理 -一次最多处理10个视频
安装
pip(推荐)
pip install yt-transcript-mcp来源
git clone https://github.com/alex2zimmermann-ux/yt-transcript-mcp
cd yt-transcript-mcp
pip install .配置
克劳德桌面版
添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"youtube-transcript": {
"command": "yt-transcript-mcp",
"env": {
"YT_MCP_MODE": "standalone"
}
}
}
}环境变量
| 变量 | 默认值 | 描述 |
|---|---|---|
YT_MCP_MODE | standalone | standalone 或 backend |
YT_MCP_BACKEND_URL | http://localhost:8300 | 后端服务URL |
YT_MCP_BACKEND_API_KEY | - | 后端的API密钥 |
YT_MCP_CACHE_MAX_SIZE | 100 | 最大缓存条目数 |
YT_MCP_CACHE_TTL_SECONDS | 3600 | 缓存TTL(秒) |
YT_MCP_RATE_LIMIT_PER_MINUTE | 30 | 费率限制 |
YT_MCP_TRANSPORT | stdio | stdio 或 streamable-http |
模式
独立(默认)
用途 youtube-transcript-api 直接。轻量级,无外部依赖。最适合市场部署。
后端
连接到支持Cookie、yt-dlp和Whisper回退的正在运行的转录服务(FastAPI)。最适合高级/自托管使用。
工具
get_transcript
获取YouTube视频的文字记录。
参数:
url(必填)-YouTube URL或视频IDlanguage(可选,默认:“en”)-语言代码format(可选,默认:“text”)-“text”、“segments”或“both”
search_transcript
在视频转录中搜索关键字。
参数:
url(必填)-YouTube URL或视频IDquery(必填)-搜索词language(可选,默认值:“en”)context_segments(可选,默认值:1)-要包含的周围分段
get_transcript_summary
按时间块获取成绩单以供分析。
参数:
url(必填)-YouTube URL或视频IDlanguage(可选,默认值:“en”)chunk_minutes(可选,默认值:5)
batch_transcripts
同时处理多个视频。
参数:
urls(必填)-YouTube网址或ID列表(最多10个)language(可选,默认值:“en”)
码头工人
# Standalone
docker compose --profile standalone up
# Backend
YT_MCP_BACKEND_API_KEY=your-key docker compose --profile backend up发展
python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
pytest tests/ -v --cov许可证
麻省理工学院
