Yt Transcript MCP

YouTube转录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"
      }
    }
  }
}

环境变量

模式

独立（默认）

用途 youtube-transcript-api 直接。轻量级，无外部依赖。最适合市场部署。

后端

连接到支持Cookie、yt-dlp和Whisper回退的正在运行的转录服务（FastAPI）。最适合高级/自托管使用。

工具

get_transcript

获取YouTube视频的文字记录。

参数：

• url （必填）-YouTube URL或视频ID
• language （可选，默认：“en”）-语言代码
• format （可选，默认：“text”）-“text”、“segments”或“both”

search_transcript

在视频转录中搜索关键字。

参数：

• url （必填）-YouTube URL或视频ID
• query （必填）-搜索词
• language （可选，默认值：“en”）
• context_segments （可选，默认值：1）-要包含的周围分段

get_transcript_summary

按时间块获取成绩单以供分析。

参数：

• url （必填）-YouTube URL或视频ID
• language （可选，默认值：“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

许可证

麻省理工学院